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 SP2、Windows Vista SP1 和 Windows Vista SP2 上的Windows Management Framework