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

FindByUDN メソッドは、一意のデバイス名 (UDN) でデバイスを同期的に検索します。

構文

HRESULT FindByUDN(
  [in]  BSTR        bstrUDN,
  [out] IUPnPDevice **pDevice
);

[in] bstrUDN

検索する UDN を指定します。この値では大文字と小文字が区別され、小文字 (uuid:e8f85dfd-ff..など) として指定する必要があります。

[out] pDevice

要求されたデバイスを含む IUPnPDevice オブジェクトへの参照を受け取ります。指定したデバイスが見つからない場合は NULL を 受け取ります。

メソッドが成功した場合、戻り値はS_OK。それ以外の場合、メソッドは S_FALSEを返します。

このメソッドは、指定された UDN に一致するデバイスが見つかるとすぐにを返します。デバイスが見つからない場合、メソッドが返されるまでに少なくとも 9 秒かかり、場合によっては長くなります。