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

この呼び出しの前に開始された BeginInvokeAction 操作に対応する 64 ビット ULONG 値。

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

リターンコード	説明
UPNP_E_DEVICE_TIMEOUT	デバイスが 30 秒のタイムアウト期間内に応答していません。
UPNP_E_DEVICE_ERROR	不明なエラーが発生しました。
UPNP_E_INVALID_ARGUMENTS	渡された 1 つ以上の引数が無効です。
UPNP_E_INVALID_ACTION	このアクションは、デバイスではサポートされていません。
UPNP_E_ERROR_PROCESSING_RESPONSE	デバイスから、処理できない応答が送信されました。たとえば、応答が破損しています。
UPNP_E_PROTOCOL_ERROR	UPnP コントロールプロトコルレベルでエラーが発生しました。
UPNP_E_TRANSPORT_ERROR	HTTP エラーが発生しました。実際の HTTP 状態コードを取得するには、 IUPnPService::LastTransportStatus プロパティを使用します。メモこのエラーコードは、SOAP 応答が 100 キロバイトを超えた場合にも返されます。

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