WSManPluginGetOperationParameters 関数 (wsman.h)

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

操作に関連付けられているタイムアウトやデータ制限などの項目の操作情報を取得します。プラグインでは、情報目的以外の目的でこれらのパラメーターを使用しないでください。

構文

DWORD WSManPluginGetOperationParameters(
  [in]  WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]  DWORD                flags,
  [out] WSMAN_DATA           *data
);

パラメーター

[in] requestDetails

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

[in] flags

取得に使用できるオプションを指定します。このパラメーターは、次のいずれかの値またはプラグインによって定義された値に設定する必要があります。

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

操作応答パケットの最大サイズを指定します。サイズには、データのサイズと簡易オブジェクトアクセスプロトコル (SOAP) のオーバーヘッドが含まれます。

メモ一部の操作では、プラグインを 1 回呼び出すと、複数のラウンドトリップが発生する可能性があります。このメソッドが呼び出されたときにデータを待機している要求がない場合は、前のパケットの最大エンベロープサイズが指定されます。

WSMAN_PLUGIN_PARAMS_TIMEOUT (2)

現在の操作のタイムアウトを指定します。

メモ一部の操作では、プラグインを 1 回呼び出すと、複数のラウンドトリップが発生する可能性があります。このメソッドが呼び出されたときにデータを待機している要求がない場合は、前のパケットのタイムアウトが指定されます。

WSMAN_PLUGIN_PARAMS_REMAINING_RESULT_SIZE (3)

現在の操作のデータに残っている領域の量を指定します。サイズは、操作の種類に基づいています。たとえば、このフラグは、取得操作の 1 つの結果項目の大きさを表します。列挙の場合、各オブジェクトが追加されると、サイズが小さくなります。現在のパケットに列挙型と get 操作が入力されると、さらに多くのデータが受け入れられキャッシュされている場合でも、クライアントに返されます。

メモ一部の操作では、プラグインを 1 回呼び出すと、複数のラウンドトリップが発生する可能性があります。このメソッドが呼び出されたときにデータを待機している要求がない場合は、キャッシュされたアイテムの残りのサイズが指定されます。

WSMAN_PLUGIN_PARAMS_LARGEST_RESULT_SIZE (4)

現在の操作のデータの最大サイズを指定します。

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_LOCALE (5)

操作に対してクライアントによって要求された言語ロケールを指定します。

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_DATA_LOCALE (6)

クライアントによって要求されたデータの言語ロケールを指定します。

[out] data

結果オブジェクトを指定する WSMAN_DATA 構造体へのポインター。

戻り値

メソッドは、 成功した場合NO_ERROR を返します。それ以外の場合は、エラーコードを返します。最も一般的なエラーコードを次に示します。

要件

要件	値
サポートされている最小のクライアント	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

次の方法で共有