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

備註

作業必須發出作業回呼的訊號，以指出作業已關閉。 作業會以階層方式取消，以確保在最上層作業之前取消所有後續作業。 外掛程式有兩種處理作業取消的方式。 首先，如果外掛程式逐一查看一組結果，外掛程式可以檢查 shutdownNotification 布爾值。 其次，如果外掛程式本質上更異步，則當佇列異步通知線程時，可以使用 shutdownNotificationHandle 。

規格需求

需求	值
最低支援的用戶端	Windows 7
最低支援的伺服器	Windows Server 2008 R2
標頭	wsman.h
可轉散發套件	windows Server 2008 SP2、Windows Vista SP1 和 Windows Vista SP2 上的 Windows Management Framework