Metodo IUPnPDeviceFinder::FindByUDN (upnp.h)

Il metodo FindByUDN cerca in modo sincrono un dispositivo in base al nome univoco del dispositivo (UDN).

Sintassi

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

Parametri

[in] bstrUDN

Specifica l'UDN per cui eseguire la ricerca. Questo valore è distinzione tra maiuscole e minuscole( ad esempio uuid:e8f85dfd-ff...).

[out] pDevice

Riceve un riferimento a un oggetto IUPnPDevice che contiene il dispositivo richiesto. Riceve NULL se il dispositivo specificato non viene trovato.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce S_FALSE.

Commenti

Questo metodo restituisce non appena viene trovato un dispositivo corrispondente all'UDN specificato. Se non viene trovato alcun dispositivo, il metodo richiede almeno nove secondi per restituire e possibilmente più lungo.

Requisiti

Vedi anche

IUPnPDeviceFinder

IUPnPDeviceFinder::FindByType

IUPnPDevices