IUPnPServiceAsync::EndQueryStateVariable メソッド (upnp.h)

EndQueryStateVariable メソッドは、前の BeginQueryStateVariable 操作の結果を取得し、結果のサービス固有の状態変数値を取得します。

構文

HRESULT EndQueryStateVariable(
  [in]          ULONG64 ullRequestID,
  [out, retval] VARIANT *pValue
);

[in] ullRequestID

この呼び出しの前に開始された BeginQueryStateVariable 操作に対応する 64 ビット ULONG 値へのポインター。

[out, retval] pValue

入力時に、には空の配列が含まれます。出力時に、 BeginQueryStateVariable by bstrVariableName で指定された変数の値への参照を受け取ります。返されるデータの型は、クエリが呼び出された状態変数によって異なります。

メモVariantClear でこのパラメーターをクリアします。

成功すると S_OK を返します。それ以外の場合、メソッドは WinError.h で定義されている COM エラーコードまたは次のいずれかの値を返します。

リターンコード	説明
UPNP_E_DEVICE_ERROR	状態変数はイベントされず、リモートクエリからエラーコードが返されました。これはトランスポートエラーではありません。デバイスは要求を受信しましたが、エラーが返されました。
UPNP_E_INVALID_VARIABLE	要求された状態変数が存在しません。
UPNP_E_DEVICE_TIMEOUT	デバイスが 30 秒のタイムアウト期間内に応答していません。
UPNP_E_INVALID_ARGUMENTS	vInActionArgs で渡された 1 つ以上の引数が無効です。
UPNP_E_PROTOCOL_ERROR	UPnP プロトコルレベルで問題が発生したため、クエリが完了しませんでした。
UPNP_E_TRANSPORT_ERROR	状態変数はイベントされず、HTTP の問題のために値のリモートクエリが失敗しました。 HTTP エラーコードを取得するには、 IUPnPService::LastTransportStatus を使用します。
UPNP_E_VARIABLE_VALUE_UNKNOWN	状態変数はイベントが発生しますが、UPnP ソフトウェアはイベント通知を待機しているため、値を返すことができません。

メモ一部の値は、UPnP 認定デバイスからエラーが受信されたことを示す場合があります。詳細については、「デバイスエラーコード」を参照してください。