共用方式為

IUPnPServiceAsync：：BeginQueryStateVariable 方法 (upnp.h)

  • 發行項

BeginQueryStateVariable方法會從特定服務起始狀態變數值的非同步要求。 此外，如果已針對延遲的服務控制通訊協定描述指出加入宣告， (SCPD) 下載和事件訂用帳戶，而且尚未進行，此方法將會起始 SCPD 下載和事件訂用帳戶。

語法

HRESULT BeginQueryStateVariable(
  [in]           BSTR             bstrVariableName,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

參數

[in] bstrVariableName

指定要求的狀態變數值。

[in, optional] pAsyncResult

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

[out] pullRequestID

用來識別非同步 I/O 作業的 64 位 ULONG 值的指標。 使用 EndQueryStateVariable結束或取消此作業時，UPnP 控制點必須使用這個控制碼。

傳回值

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

傳回碼 Description
E_FAIL
 無法起始非同步作業。
UPNP_E_INVALID_VARIABLE
 bstrVariableName所指示的要求狀態變數不存在。
 
注意 某些值可能表示從 UPnP 認證的裝置收到錯誤。 如需詳細資訊，請參閱 裝置錯誤碼。
 

備註

使用此方法查詢任何事件狀態變數之前，應該先完成事件訂閱。 如果未發生此情況，則會傳回 UPNP_E_VARIABLE_VALUE_UNKNOWN ，而且事件訂閱會在內部進行。 因此，下一個 BeginQueryStateVariable 呼叫將會成功。

注意 對於沒有事件變數的服務，此方法一律會如預期般運作。
 

規格需求

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

另請參閱

IUPnPServiceAsync

IUPnPServiceAsync：：CancelAsyncOperation