WSManPluginReceiveResult 函数 (wsman.h)

项目
03/13/2024

报告 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

除 commandState 为WSMAN_RECEIVE_STATE_NORMAL_TERMINATION或WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION外，在所有情况下均忽略。每个结果可以有单独的错误代码。如果命令或流失败，插件必须调用 WSManPluginOperationComplete 方法。

返回值

无

要求

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

通过