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

функция обратного вызова WSMAN_PLUGIN_STARTUP (wsman.h)

  • Статья

Определяет обратный вызов запуска для подключаемого модуля. Так как в одном процессе может размещаться несколько приложений, этот метод можно вызывать несколько раз, но только один раз для каждой инициализации приложения. Подключаемый модуль можно инициализировать несколько раз в рамках одного процесса, но только один раз для каждого значения applicationIdentification . Контекст, возвращаемый этим методом, должен быть специфичным для приложения. Возвращаемый контекст будет передаваться во все последующие вызовы подключаемого модуля, относящиеся к приложению. Все подключаемые модули удаленного управления Windows (WinRM) должны реализовывать эту функцию обратного вызова.

Имя точки входа DLL для этого метода должно быть WSManPluginStartup.

Синтаксис

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

DWORD WsmanPluginStartup(
  DWORD flags,
  PCWSTR applicationIdentification,
  PCWSTR extraInfo,
  PVOID *pluginContext
)
{...}

Параметры

flags

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

applicationIdentification

Уникальный идентификатор размещенного приложения. Для службы main WinRM по умолчанию используется wsman. Для узла служб IIS этот идентификатор связан с конечной точкой приложения для этого узла. Например, wsman/MyCompany/MyApplication.

extraInfo

Строка, содержащая сведения о конфигурации, если какие-либо сведения были сохранены при регистрации подключаемого модуля. При регистрации подключаемого модуля с помощью конфигурации WinRM подключаемый модуль может добавлять дополнительные параметры конфигурации, которые будут полезны во время инициализации на необязательный узел. Эти сведения могут быть особенно полезны, если подключаемый модуль используется в разных сценариях размещения IIS и требует немного другой семантики времени выполнения во время инициализации. Эта строка является копией XML из конфигурации, если она присутствует. В противном случае этому параметру присваивается значение NULL.

pluginContext

Контекст для инициализации конкретного приложения. Этот контекст передается во все остальные вызовы подключаемого модуля WinRM, связанные с этим applicationIdentifier.

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

При успешном выполнении метод возвращает NO_ERROR . в противном случае возвращается код ошибки. Если этот метод возвращает ошибку, точка входа WSManPluginShutdown вызываться не будет.

Требования

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