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 を使用できます。

要件