IUPnPServiceAsync：：EndInvokeAction 方法 (upnp.h)

EndInvokeAction 方法會擷取先前 BeginInvokeAction 作業的結果，並擷取結果輸出自變數。

語法

HRESULT EndInvokeAction(
  [in, out] ULONG64 ullRequestID,
  [in, out] VARIANT *pvOutActionArgs,
  [in]      VARIANT *pvRetVal
);

[in, out] ullRequestID

在輸入上，包含空陣列的參考。在輸出上，接收服務特定輸出自變數數位的參考。如果動作沒有輸出自變數，此參數會包含空陣列。

注意使用 VariantClear 清除此參數。

[in, out] pvOutActionArgs

在輸入上，包含空陣列的參考。在輸出中，接收 VARIANT 的參考，其中包含所叫用動作的傳回值。

注意使用 VariantClear 清除此參數。

[in] pvRetVal

64 位 ULONG 值，對應至此呼叫之前起始的 BeginInvokeAction 作業。

傳回成功時的 S_OK 。否則，方法會傳回 WinError.h 或下列其中一個值中定義的 COM 錯誤碼：

傳回碼	Description
UPNP_E_DEVICE_TIMEOUT	裝置未在 30 秒逾時期間內回應。
UPNP_E_DEVICE_ERROR	發生未知的錯誤。
UPNP_E_INVALID_ARGUMENTS	傳遞的一或多個自變數無效。
UPNP_E_INVALID_ACTION	裝置不支援此動作。
UPNP_E_ERROR_PROCESSING_RESPONSE	裝置已傳送無法處理的回應;例如，回應已損毀。
UPNP_E_PROTOCOL_ERROR	UPnP 控制通訊協定層級發生錯誤。
UPNP_E_TRANSPORT_ERROR	發生 HTTP 錯誤。使用 IUPnPService：：LastTransportStatus 屬性來取得實際的 HTTP 狀態代碼。注意當 SOAP 回應超過 100 KB 時，也會傳回此錯誤碼。

注意某些值可能表示從 UPnP 認證的裝置收到錯誤。如需詳細資訊，請參閱裝置錯誤碼。