Fonction WSManSetSessionOption (wsman.h)

Article
03/04/2024

Définit un ensemble étendu d’options pour la session.

Syntaxe

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

Paramètres

[in] session

Spécifie le handle de session retourné par un appel WSManCreateSession . Ce paramètre ne peut pas avoir la valeur NULL.

option

Spécifie l’option à définir. Ce paramètre doit être défini sur l’une des valeurs de l’énumération WSManSessionOption .

[in] data

Pointeur vers une structure WSMAN_DATA qui définit la valeur d’option.

Valeur retournée

Cette méthode retourne zéro en cas de réussite. Sinon, cette méthode retourne un code d’erreur.

Remarques

Si la méthode WSManSetSessionOption est appelée avec des valeurs différentes spécifiées pour le paramètre d’option , l’ordre des différentes options est important. La première fois que WSManSetSessionOption est appelé, le transport est défini pour la session. Si un deuxième appel demande un autre type de transport, l’appel échoue.

Par exemple, le deuxième appel de méthode échoue si les méthodes sont appelées dans l’ordre suivant :

WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)

Le premier appel de méthode définit le transport sur HTTP, car le paramètre d’option a la valeur WSMAN_OPTION_UNENCRYPTED_MESSAGES. Le deuxième appel échoue, car l’option qui a été passée s’applique à HTTPS et le transport a été défini sur HTTP par le premier message.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	wsman.h
Bibliothèque	WsmSvc.lib
DLL	WsmSvc.dll
Composant redistribuable	Windows Management Framework sur Windows Server 2008 avec SP2, Windows Vista avec SP1 et Windows Vista avec SP2

Partager via