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


структура WSMAN_PLUGIN_REQUEST (wsman.h)

Указывает сведения для запроса подключаемого модуля. Указатель на структуру WSMAN_PLUGIN_REQUEST передается во все точки входа операций в подключаемом модуле. Все методы уведомления о результатах используют этот указатель для сопоставления результата с запросом. Все сведения в структуре будут оставаться действительными до тех пор, пока подключаемый модуль не вызовет WSManPluginOperationComplete для операции.

Синтаксис

typedef struct _WSMAN_PLUGIN_REQUEST {
  WSMAN_SENDER_DETAILS *senderDetails;
  PCWSTR               locale;
  PCWSTR               resourceUri;
  WSMAN_OPERATION_INFO *operationInfo;
  BOOL                 shutdownNotification;
  HANDLE               shutdownNotificationHandle;
  PCWSTR               dataLocale;
} WSMAN_PLUGIN_REQUEST;

Члены

senderDetails

Указатель на структуру WSMAN_SENDER_DETAILS , указывающую сведения о клиенте, который инициировал запрос.

locale

Указывает языковой стандарт, в котором пользователь запрашивал результаты. Если запрошенный языковой стандарт недоступен, доступны следующие параметры:

  • Используется языковой стандарт системы.
  • Запрос отклоняется с ошибкой недопустимого языкового стандарта.
При любом вызове подключаемого модуля в потоке будет задан языковой стандарт, указанный в этом элементе. Если подключаемый модуль имеет другие потоки, работающие с запросом, ему потребуется соответствующим образом задать языковой стандарт для каждого потока, который он использует.

resourceUri

Указывает URI ресурса для этой операции.

operationInfo

Указатель на структуру WSMAN_OPERATION_INFO , содержащую дополнительные сведения об операции. Некоторые сведения в этой структуре будут иметь значение NULL , так как не все параметры относятся ко всем операциям.

shutdownNotification

Если операция отменена, член shutdownNotification имеет значение TRUE.

shutdownNotificationHandle

Если операция отменена, подается сигнал shutdownNotification .

dataLocale

Комментарии

Операции должны сигнализировать о том, что обратный вызов операции был завершен. Операции отменяются иерархическим образом, чтобы гарантировать отмену всех последующих операций перед операциями верхнего уровня. Подключаемый модуль имеет два способа обработки отмены операции. Во-первых, подключаемый модуль может проверка логическое значение shutdownNotification, если он выполняет итерацию по набору результатов. Во-вторых, если подключаемый модуль является более асинхронным, при постановке в очередь асинхронных потоков уведомлений можно использовать shutdownNotificationHandle .

Требования

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