Funzione WSManCreateSession (wsman.h)

Crea un oggetto sessione.

Sintassi

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

Parametri

[in] apiHandle

Specifica l'handle API restituito dalla chiamata WSManInitialize . Questo parametro non può essere NULL.

[in, optional] connection

Indica a quale protocollo e agente connettersi. Se questo parametro è NULL, per impostazione predefinita la connessione sarà localhost (127.0.0.1). Questo parametro può essere un nome host semplice o un URL completo. Il formato è il seguente:

[transport://]host[:p ort][/prefisso] dove:

Elemento Descrizione
transport HTTP o HTTPS. Il valore predefinito è HTTP.
host Può essere in un nome DNS, un nome NetBIOS o un indirizzo IP.
port Il valore predefinito è 80 per HTTP e su 443 per HTTPS. Le impostazioni predefinite possono essere modificate nella configurazione locale.
prefix Qualsiasi stringa. Il valore predefinito è "wsman". Il valore predefinito può essere modificato nella configurazione locale.

flags

Riservato per utilizzi futuri. Deve essere zero.

[in, optional] serverAuthenticationCredentials

Definisce il metodo di autenticazione, ad esempio Negotiate, Kerberos, Digest, Basic o certificato client. Se il meccanismo di autenticazione è Negotiate, Kerberos, Digest o Basic, la struttura può contenere anche le credenziali usate per l'autenticazione. Se viene usata l'autenticazione del certificato client, è necessario specificare l'identificazione personale del certificato.

Se vengono specificate credenziali, questo parametro contiene il nome utente e la password di un account locale o di un account di dominio. Se questo parametro è NULL, vengono usate le credenziali predefinite. Le credenziali predefinite sono le credenziali in cui è in esecuzione il thread corrente. Il client deve specificare in modo esplicito le credenziali quando viene usata l'autenticazione di base o digest. Se vengono usate credenziali esplicite, il nome utente e la password devono essere validi. Per altre informazioni sulle credenziali di autenticazione, vedere la struttura WSMAN_AUTHENTICATION_CREDENTIALS .

[in, optional] proxyInfo

Puntatore a una struttura WSMAN_PROXY_INFO che specifica le informazioni del proxy. Questo valore può essere NULL.

[out] session

Definisce l'handle di sessione che identifica in modo univoco la sessione. Questo parametro non può essere NULL. Questo handle deve essere chiuso chiamando il metodo WSManCloseSession .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è zero. In caso contrario, il valore restituito è un codice di errore.

Requisiti

   
Client minimo supportato Windows 7
Server minimo supportato Windows Server 2008 R2
Piattaforma di destinazione Windows
Intestazione wsman.h
Libreria WsmSvc.lib
DLL WsmSvc.dll
Componente ridistribuibile Windows Management Framework in Windows Server 2008 con SP2 e Windows Vista con SP2