WSManPluginReceiveResult 関数 (wsman.h)

[アーティクル]
08/28/2023

WSMAN_PLUGIN_RECEIVE プラグイン呼び出しの結果を報告し、結果を返すほとんどのシェルプラグインで使用されます。すべてのデータを受信したら、 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

リソース URI、オプション、ロケール、シャットダウンフラグ、および要求のハンドルを指定するWSMAN_PLUGIN_REQUEST構造体へのポインター。

[in] flags

将来利用するために予約されています。 0 に設定する必要があります。

[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

次の方法で共有