次の方法で共有

WSMAN_PLUGIN_REQUEST 構造体 (wsman.h)

  • [アーティクル]

プラグイン要求の情報を指定します。 WSMAN_PLUGIN_REQUEST構造体へのポインターは、プラグイン内のすべての操作エントリ ポイントに渡されます。 すべての結果通知メソッドは、このポインターを使用して、結果と要求を照合します。 構造体内のすべての情報は、プラグインが操作で WSManPluginOperationComplete を呼び出すまで有効なままです。

構文

typedef struct _WSMAN_PLUGIN_REQUEST {
  WSMAN_SENDER_DETAILS *senderDetails;
  PCWSTR               locale;
  PCWSTR               resourceUri;
  WSMAN_OPERATION_INFO *operationInfo;
  BOOL                 shutdownNotification;
  HANDLE               shutdownNotificationHandle;
  PCWSTR               dataLocale;
} WSMAN_PLUGIN_REQUEST;

メンバー

senderDetails

要求を開始したクライアントに関する詳細を指定する WSMAN_SENDER_DETAILS 構造体へのポインター。

locale

ユーザーが結果を要求したロケールを指定します。 要求されたロケールが使用できない場合は、次のオプションを使用できます。

  • システム ロケールが使用されます。
  • 要求が無効なロケール エラーで拒否されました。
プラグインを呼び出すと、スレッドのロケールがこのメンバーで指定されているロケールに設定されます。 プラグインに要求で動作する他のスレッドがある場合、プラグインは、使用する各スレッドに応じてロケールを設定する必要があります。

resourceUri

この操作の リソース URI を 指定します。

operationInfo

操作に関する追加情報を含む WSMAN_OPERATION_INFO 構造体へのポインター。 すべてのパラメーターがすべての操作に関連しているわけではないため、この構造体の情報の一部は NULL になります。

shutdownNotification

操作が取り消された場合、 shutdownNotification メンバーは TRUE に設定されます。

shutdownNotificationHandle

操作が取り消されると、 shutdownNotification が通知されます。

dataLocale

注釈

操作は、操作がシャットダウンされたことを示すためにコールバックを通知する必要があります。 最上位レベルの操作の前にすべての後続操作が取り消されるように、階層的な方法で操作が取り消されます。 プラグインには、操作の取り消しを処理する 2 つの方法があります。 まず、プラグインが一連の結果を反復処理する場合、shutdownNotification ブール値をチェックできます。 次に、プラグインが本質的により非同期である場合、非同期通知スレッドをキューに入れるときに shutdownNotificationHandle を使用できます。

要件

要件 値
サポートされている最小のクライアント Windows 7
サポートされている最小のサーバー Windows Server 2008 R2
Header wsman.h
再頒布可能パッケージ Windows Server 2008 SP2、Windows Vista sp1、Windows Vista sp2 でのWindows Management Framework