Поделиться через


Функция WSManSetSessionOption (wsman.h)

Задает расширенный набор параметров для сеанса.

Синтаксис

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

Параметры

[in] session

Указывает дескриптор сеанса, возвращаемый вызовом WSManCreateSession . Этот параметр не может иметь значение NULL.

option

Задает параметр, который необходимо задать. Этому параметру необходимо задать одно из значений перечисления WSManSessionOption .

[in] data

Указатель на структуру WSMAN_DATA , которая определяет значение параметра.

Возвращаемое значение

Этот метод возвращает ноль при успешном выполнении. В противном случае этот метод возвращает код ошибки.

Комментарии

Если вызывается метод WSManSetSessionOption с разными значениями , указанными для параметра option , важен порядок различных параметров. При первом вызове WSManSetSessionOption задается транспорт для сеанса. Если второй вызов запрашивает другой тип транспорта, вызов завершится ошибкой.

Например, второй вызов метода завершится ошибкой, если методы вызываются в следующем порядке:

  • WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
  • WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)
Первый вызов метода задает для транспорта значение HTTP, так как параметру параметра задано значение WSMAN_OPTION_UNENCRYPTED_MESSAGES. Второй вызов завершается сбоем, так как переданный параметр применяется для ПРОТОКОЛА HTTPS, а для транспорта в первом сообщении задано значение HTTP.

Требования

Требование Значение
Минимальная версия клиента Windows 7
Минимальная версия сервера Windows Server 2008 R2
Целевая платформа Windows
Header wsman.h
Библиотека WsmSvc.lib
DLL WsmSvc.dll
Распространяемые компоненты Windows Management Framework в Windows Server 2008 с пакетом обновления 2 (SP2), Windows Vista с пакетом обновления 1 (SP1) и Windows Vista с пакетом обновления 2 (SP2)