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초 이상 걸리며 더 오래 걸릴 수 있습니다.