Funzione WSManCreateSession (wsman.h)
Crea un oggetto sessione.
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
);
[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 .
Se la funzione ha esito positivo, il valore restituito è zero. In caso contrario, il valore restituito è un codice di errore.
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 |