Metodo IUPnPDescriptionDocument::D eviceByUDN (upnp.h)

Il metodo DeviceByUDN restituisce il dispositivo con il nome univoco (UDN) specificato contenuto nel documento di descrizione caricato.

Sintassi

HRESULT DeviceByUDN(
  [in]  BSTR        bstrUDN,
  [out] IUPnPDevice **ppudDevice
);

Parametri

[in] bstrUDN

Specifica il nome UDN del dispositivo.

[out] ppudDevice

Riceve un riferimento a un oggetto IUPnPDevice che descrive il dispositivo. Questo riferimento deve essere rilasciato quando non viene più usato.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti in WinError.h.

Commenti

Usare DeviceByUDN dopo aver caricato la descrizione del dispositivo usando IUPnPDescriptionDocument::Load o IUPnPDescriptionDocument::LoadAsync. La proprietà IUPnPDescriptionDocument::ReadyState restituisce READYSTATE_COMPLETED.

Non usare DeviceByUDN a meno che non venga caricata una descrizione del dispositivo usando IUPnPDescriptionDocument::Load o IUPnPDescriptionDocument::LoadAsync. L'operazione di ricerca cerca solo nella descrizione del dispositivo attualmente caricata.

Requisiti

Vedi anche

IUPnPDescriptionDocument

IUPnPDevice