IUPnPDeviceFinder::FindByType メソッド (upnp.h)

FindByType メソッドは、デバイスの種類またはサービスの種類によってデバイスを同期的に検索します。

構文

HRESULT FindByType(
  [in]  BSTR         bstrTypeURI,
  [in]  DWORD        dwFlags,
  [out] IUPnPDevices **pDevices
);

[in] bstrTypeURI

検索するデバイスまたはサービスの種類の URI の種類を指定します。

[in] dwFlags

ゼロを指定してください。このパラメーターは将来使用するために予約されています。

[out] pDevices

見つかった IUPnPDevices デバイスのコレクションへの参照を受け取ります。

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

このメソッドは、検索が完了するまで戻りません。検索には少なくとも 9 秒かかる場合があり、場合によってはそれ以上かかる場合があります。このメソッドは、ユーザーインターフェイスメッセージを処理するスレッドから呼び出してはなりません。