IUPnPDeviceFinder::FindByUDN method (upnp.h)
The FindByUDN method searches synchronously for a device by its unique device name (UDN).
Syntax
HRESULT FindByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **pDevice
);
Parameters
[in] bstrUDN
Specifies the UDN for which to search. This value is case sensitive, and should be provided as lower-case (e.g. uuid:e8f85dfd-ff...).
[out] pDevice
Receives a reference to an IUPnPDevice object that contains the requested device. Receives NULL if the specified device is not found.
Return value
If the method succeeds, the return value is S_OK. Otherwise, the method returns S_FALSE.
Remarks
This method returns as soon as a device that matches the specified UDN is found. If no device is found, the method takes at least nine seconds to return, and possibly longer.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | None supported |
Target Platform | Windows |
Header | upnp.h |
DLL | Upnp.dll |