Metodo IWSMan::CreateSession (wsmandisp.h)

Articolo
08/28/2023

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'autenticazione digest, 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

Per altre informazioni, vedere Autenticazione per connessioni remote e il parametro connectionOptions .

[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


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wsmandisp.h
Libreria	WSManDisp.tlb
DLL	WSMAuto.dll

Vedi anche

IWSMan

WSMan.CreateSession

Condividi tramite