共用方式為

IUPnPServiceAsync：：BeginInvokeAction 方法 (upnp.h)

  • 發行項

BeginInvokeAction 方法會在異步模式的裝置上叫用動作。 此外，如果選擇加入延遲的 SCPD 下載和事件訂用帳戶，而且尚未進行，這個方法將會起始 SCPD 下載。

語法

HRESULT BeginInvokeAction(
  [in]           BSTR             bstrActionName,
  [in]           VARIANT          vInActionArgs,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

參數

[in] bstrActionName

指定要叫用的方法。

[in] vInActionArgs

指定方法的輸入自變數陣列。 如果動作沒有輸入自變數，此參數必須包含空陣列。 此陣列的內容是服務特定的。

[in, optional] pAsyncResult

IUPnPAsyncResult 物件的指標。 當 BeginInvokeAction 呼叫完成時，UPnP 會使用 IUPnPAsyncResult：：AsyncOperationComplete 方法來通知控制點。

[out] pullRequestID

用來識別異步 I/O 作業之 64 位 ULONG 值的指標。 使用 EndInvokeAction 結束或取消此作業時，控制點必須使用這個句柄做為 Cookie。

傳回值

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

傳回碼 Description
E_PENDING
 這個 IUPnPServiceAsync 物件上正在執行另一個異步操作。 建立另一個 IUPnPServiceAsync 實例，或使用 IUPnPServiceAsync：：CancelAsyncOperation 取消執行中的作業。
E_FAIL
 無法起始作業。
UPNP_E_INVALID_ACTION
 裝置不支援此動作。
 
注意 某些值可能表示從 UPnP 認證的裝置收到錯誤。 如需詳細資訊，請參閱 裝置錯誤碼。
 

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 upnp.h
Dll Upnp.dll

另請參閱

IUPnPServiceAsync

IUPnPServiceAsync：：EndInvokeAction