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


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

Создает объект 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