WSManGetSessionOptionAsString-Funktion (wsman.h)

Ruft den Wert einer Sitzungsoption ab.

Syntax

DWORD WSManGetSessionOptionAsString(
  [in]            WSMAN_SESSION_HANDLE session,
                  WSManSessionOption   option,
                  DWORD                stringLength,
  [out, optional] PWSTR                string,
  [out]           DWORD                *stringLengthUsed
);

Parameter

[in] session

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

option

Gibt die abzurufende Option an. Nicht alle Sitzungsoptionen können abgerufen werden. Die Werte für die Optionen werden in der WSManSessionOption-Enumeration definiert.

stringLength

Gibt die Länge des Speicherorts für den Zeichenfolgenparameter an.

[out, optional] string

Ein Zeiger auf den Speicherort für den Wert der angegebenen Sitzungsoption.

[out] stringLengthUsed

Gibt die Länge der im Zeichenfolgenparameter zurückgegebenen Zeichenfolge an.

Rückgabewert

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

Anforderungen