wSManPluginReceiveResult 函数 (wsman.h)

报告 WSMAN_PLUGIN_RECEIVE 插件调用的结果,并由返回结果的大多数 shell 插件使用。 收到所有数据后,必须调用 WSManPluginOperationComplete 方法。

语法

DWORD WSManPluginReceiveResult(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD                flags,
  [in, optional] PCWSTR               stream,
  [in, optional] WSMAN_DATA           *streamResult,
  [in, optional] PCWSTR               commandState,
  [in]           DWORD                exitCode
);

参数

[in] requestDetails

指向 WSMAN_PLUGIN_REQUEST 结构的指针,用于指定请求的资源 URI、选项、区域设置、关闭标志和句柄。

[in] flags

保留供将来使用。 必须设置为零。

[in, optional] stream

指定数据与之关联的流。 可以使用任何流,但标准流为 STDIN、STDOUT 和 STDERR。

[in, optional] streamResult

指向 WSMAN_DATA 结构的指针,该结构指定返回给客户端的结果对象。 结果可以采用二进制格式或 XML 格式。

[in, optional] commandState

指定命令的状态。 此参数必须设置为以下值之一或插件定义的值之一。

WSMAN_RECEIVE_STATE_NONE

该操作不需要执行任何操作。

WSMAN_RECEIVE_STATE_NORMAL_TERMINATION

操作正常终止。

WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION

操作意外终止。

WSMAN_RECEIVE_STATE_WAITING

操作正在等待输入。

WSMAN_RECEIVE_STATE_INPUT_REQUIRED

此操作需要命令行输入。

[in] exitCode

commandStateWSMAN_RECEIVE_STATE_NORMAL_TERMINATIONWSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION外,在所有情况下都忽略。 每个结果可以有单独的错误代码。 如果命令或流失败,插件必须调用 WSManPluginOperationComplete 方法。

返回值

要求

   
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
目标平台 Windows
标头 wsman.h
Library WsmSvc.lib
DLL WsmSvc.dll
可再发行组件 windows Server 2008 上的Windows Management Framework SP2 和具有 SP2 的 Windows Vista