Метод IWSMan::CreateSession (wsmandisp.h)

Статья
08/28/2023

Создает объект Session , который затем можно использовать для последующих сетевых операций.

Синтаксис

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Параметры

[in] connection

Протокол и служба для подключения, включая IPv4 или IPv6. Формат сведений о подключении выглядит следующим образом: <Суффикс>адреса><транспорта><. Примеры см. в разделе Примечания. Если сведения о подключении не указаны, используется локальный компьютер.

[in] flags

Флаги сеанса, указывающие метод проверки подлинности, например Согласование проверки подлинности или Дайджест-проверка подлинности, для подключения к удаленному компьютеру. Эти флаги также указывают другие сведения о подключении к сеансу, такие как кодировка или шифрование. Этот параметр должен содержать один или несколько флагов в __WSManSessionFlags для удаленного подключения. Дополнительные сведения см. в разделе Константы сеанса. Параметры флага не требуются для подключения к службе WinRM на локальном компьютере.

Если флаги проверки подлинности не указаны, используется Протокол Kerberos, если не выполняется одно из следующих условий. В этом случае используется Negotiate:

предоставляются явные учетные данные, а узел назначения является доверенным
конечным узлом является localhost, 127.0.0.1 или [::1]".
клиентский компьютер входит в рабочую группу, а узел назначения является доверенным

Дополнительные сведения см. в разделах Проверка подлинности для удаленных подключений и параметр connectionOptions .

[in] connectionOptions

Указатель на объект IWSManConnectionOptions , содержащий имя пользователя и пароль. По умолчанию имеет значение NULL.

[out] session

Указатель на новый объект IWSManSession .

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

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

В следующем списке приведены примеры форматов, используемых для указания сведений о подключении в параметре подключения (при создании сеанса < HTTPS поле Адрес> должно соответствовать имени сертификата компьютера сервера, в противном случае произойдет сбой):

"https://service"
Использует ПРОТОКОЛ HTTPS для подключения к расположению веб-службы по умолчанию.
"https://service.corp.com/websvcs/wsman"
Использует протокол HTTPS для подключения к определенному расположению веб-службы.
"https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"
Использует HTTPS и IPv6 с портом по умолчанию.
"https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:9999/wsman"
Использует HTTPS и IPv6 с заданным портом.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wsmandisp.h
Библиотека	WSManDisp.tlb
DLL	WSMAuto.dll

См. также раздел

IWSMan

WSMan.CreateSession