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

除 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