WSManSetSessionOption-Funktion (wsman.h)

Legt einen erweiterten Satz von Optionen für die Sitzung fest.

Syntax

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

Parameter

[in] session

Gibt das Sitzungshandle an, das von einem WSManCreateSession-Aufruf zurückgegeben wird. Dieser Parameter darf nicht NULL sein.

option

Gibt die festzulegende Option an. Dieser Parameter muss auf einen der Werte in der WSManSessionOption-Enumeration festgelegt werden.

[in] data

Ein Zeiger auf eine WSMAN_DATA Struktur, die den Optionswert definiert.

Rückgabewert

Diese Methode gibt bei Erfolg null zurück. Andernfalls gibt diese Methode einen Fehlercode zurück.

Hinweise

Wenn die WSManSetSessionOption-Methode mit unterschiedlichen Werten aufgerufen wird, die für den Optionsparameter angegeben sind, ist die Reihenfolge der verschiedenen Optionen wichtig. Wenn WSManSetSessionOption zum ersten Mal aufgerufen wird, wird der Transport für die Sitzung festgelegt. Wenn ein zweiter Aufruf einen anderen Transporttyp anfordert, schlägt der Aufruf fehl.

Beispielsweise schlägt der zweite Methodenaufruf fehl, wenn die Methoden in der folgenden Reihenfolge aufgerufen werden:

• WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
• WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)

Der erste Methodenaufruf legt den Transport auf HTTP fest, da der Optionsparameter auf WSMAN_OPTION_UNENCRYPTED_MESSAGES festgelegt ist. Der zweite Aufruf schlägt fehl, da die übergebene Option für HTTPS gilt und der Transport durch die erste Nachricht auf HTTP festgelegt wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	wsman.h
Bibliothek	WsmSvc.lib
DLL	WsmSvc.dll
Verteilbare Komponente	Windows Management Framework unter Windows Server 2008 mit SP2, Windows Vista mit SP1 und Windows Vista mit SP2