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

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

  • Статья

Создает объект сеанса.

Синтаксис

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

Параметры

[in] apiHandle

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

[in, optional] connection

Указывает, к какому протоколу и агенту следует подключиться. Если этот параметр имеет значение NULL, по умолчанию будет установлено подключение к localhost (127.0.0.1). Этот параметр может быть простым именем узла или полным URL-адресом. Формат будет следующим:

[transport://]host[:p ort][/prefix] где:

Элемент Описание
транспорт Http или HTTPS. Значение по умолчанию — HTTP.
узел Может содержать DNS-имя, NetBIOS-имя или IP-адрес.
порт По умолчанию используется значение 80 для HTTP и значение 443 для HTTPS. Значения по умолчанию можно изменить в локальной конфигурации.
prefix Любая строка. Значение по умолчанию — wsman. Значение по умолчанию можно изменить в локальной конфигурации.

flags

Зарезервировано для последующего использования. Должен равняться нулю.

[in, optional] serverAuthenticationCredentials

Определяет метод проверки подлинности, например Negotiate, Kerberos, Digest, Basic или сертификат клиента. Если механизм проверки подлинности — Negotiate, Kerberos, Digest или Basic, структура также может содержать учетные данные, используемые для проверки подлинности. Если используется проверка подлинности сертификата клиента, необходимо указать отпечаток сертификата.

Если указаны учетные данные, этот параметр содержит имя пользователя и пароль локальной учетной записи или учетной записи домена. Если этот параметр имеет значение NULL, используются учетные данные по умолчанию. Учетные данные по умолчанию — это учетные данные, с которыми выполняется текущий поток. Клиент должен явно указать учетные данные при использовании обычной или дайджест-проверки подлинности. Если используются явные учетные данные, имя пользователя и пароль должны быть действительными. Дополнительные сведения об учетных данных проверки подлинности см . в WSMAN_AUTHENTICATION_CREDENTIALS структуре.

[in, optional] proxyInfo

Указатель на структуру WSMAN_PROXY_INFO , указывающую сведения о прокси-сервере. Это значение может иметь значение NULL.

[out] session

Определяет дескриптор сеанса, который однозначно идентифицирует сеанс. Этот параметр не может иметь значение NULL. Этот дескриптор следует закрыть, вызвав метод WSManCloseSession .

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

Если вызов функции заканчивается удачно, возвращается нулевое значение. В противном случае возвращаемое значение является кодом ошибки.

Требования

   
Минимальная версия клиента 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 с пакетом обновления 2 (SP2)