IUPnPDeviceControl::GetServiceObject メソッド (upnphost.h)

GetServiceObject メソッドは、特定のサービスオブジェクトへの IDispatch ポインターを取得するために使用されます。デバイスホストは、サービスごとに 1 回、サービスの要求を初めて受信すると、このメソッドを呼び出します。

構文

HRESULT GetServiceObject(
  [in]  BSTR      bstrUDN,
  [in]  BSTR      bstrServiceId,
  [out] IDispatch **ppdispService
);

[in] bstrUDN

デバイスの UDN を指定します。

[in] bstrServiceId

ポインターを取得するサービスのサービス ID を指定します。

[out] ppdispService

サービスオブジェクトへの IDispatch ポインターを受け取ります。

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

このメソッドは、特定のサービスに対して制御要求またはイベントサブスクリプションを受信すると、デバイスホストによって呼び出されます。

埋め込みデバイスは、その UDN によって区別されます。