Funzione WSManSetSessionOption (wsman.h)

Imposta un set esteso di opzioni per la sessione.

Sintassi

DWORD WSManSetSessionOption(
  [in] WSMAN_SESSION_HANDLE session,
       WSManSessionOption   option,
  [in] WSMAN_DATA           *data
);

Parametri

[in] session

Specifica l'handle di sessione restituito da una chiamata WSManCreateSession . Questo parametro non può essere NULL.

option

Specifica l'opzione da impostare. Questo parametro deve essere impostato su uno dei valori nell'enumerazione WSManSessionOption .

[in] data

Puntatore a una struttura WSMAN_DATA che definisce il valore dell'opzione.

Valore restituito

Questo metodo restituisce zero in caso di esito positivo. In caso contrario, questo metodo restituisce un codice di errore.

Commenti

Se il metodo WSManSetSessionOption viene chiamato con valori diversi specificati per il parametro di opzione , l'ordine delle diverse opzioni è importante. La prima volta che viene chiamato WSManSetSessionOption , il trasporto viene impostato per la sessione. Se una seconda chiamata richiede un tipo di trasporto diverso, la chiamata avrà esito negativo.

Ad esempio, la seconda chiamata al metodo avrà esito negativo se i metodi vengono chiamati nell'ordine seguente:

• WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
• WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)

La prima chiamata al metodo imposta il trasporto su HTTP perché il parametro option è impostato su WSMAN_OPTION_UNENCRYPTED_MESSAGES. La seconda chiamata ha esito negativo perché l'opzione passata è applicabile per HTTPS e il trasporto è stato impostato su HTTP dal primo messaggio.

Requisiti

Requisito	Valore
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, Windows Vista con SP1 e Windows Vista con SP2