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 Boolean 值。 其次,如果插件本质上更异步,则可以在排队异步通知线程时使用 shutdownNotificationHandle

要求

   
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
标头 wsman.h
可再发行组件 Windows Server 2008 SP2、SP1 的 Windows Vista 和 SP2 的 Windows Vista 上的Windows Management Framework