Metodo IWSMan::CreateSession (wsmandisp.h)

Crea un oggetto Session che può quindi essere usato per le operazioni di rete successive.

Sintassi

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Parametri

[in] connection

Protocollo e servizio da connettere, tra cui IPv4 o IPv6. Il formato delle informazioni di connessione è il seguente: <Suffisso>indirizzo><trasporto><. Per esempi, vedere Osservazioni. Se non vengono fornite informazioni di connessione, viene usato il computer locale.

[in] flags

I flag di sessione che specificano il metodo di autenticazione, ad esempio l'autenticazione negoziata o l'autenticazionedigest, per la connessione a un computer remoto. Questi flag specificano anche altre informazioni di connessione sessione, ad esempio codifica o crittografia. Questo parametro deve contenere uno o più flag in __WSManSessionFlags per una connessione remota. Per altre informazioni, vedere Costanti sessione. Nessuna impostazione del flag è necessaria per una connessione al servizio WinRM nel computer locale.

Se non vengono specificati flag di autenticazione, Kerberos viene usato a meno che non venga utilizzata una delle seguenti condizioni, nel qual caso viene usato Negotiate:

• le credenziali esplicite vengono fornite e l'host di destinazione è attendibile
• l'host di destinazione è "localhost", "127.0.0.1" o "[::1]"
• il computer client si trova in un gruppo di lavoro e l'host di destinazione è attendibile

[in] connectionOptions

Puntatore a un oggetto IWSManConnectionOptions contenente un nome utente e una password. Il valore predefinito è NULL.

[out] session

Puntatore a un nuovo oggetto IWSManSession .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'elenco seguente contiene esempi di formati usati per specificare le informazioni di connessione nel parametro di connessione (quando si crea una sessione HTTPS, il < campo Indirizzo> deve corrispondere al nome del certificato del computer server, in caso contrario si verifica un errore):

• "https://service"

  Usa HTTPS per connettersi al percorso predefinito del servizio Web.

• "https://service.corp.com/websvcs/wsman"

  Usa HTTPS per connettersi alla posizione specifica del servizio Web.

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"

  Usa HTTPS e IPv6 con la porta predefinita.

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:99999/wsman"

  Usa HTTPS e IPv6 con la porta specificata.

Requisiti

Vedi anche

IWSMan

WSMan.CreateSession