Metodo IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)

Articolo
08/25/2023

Il metodo GetFunctionalObjects recupera tutti gli oggetti funzionali corrispondenti a una categoria specificata nel dispositivo.

Sintassi

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Parametri

[in] Category

REFGUID che specifica la categoria da cercare. Ciò può essere WPD_FUNCTIONAL_CATEGORY_ALL per restituire tutti gli oggetti funzionali.

[out] ppObjectIDs

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IPortableDevicePropVariantCollection contenente gli ID oggetto degli oggetti funzionali come stringhe (tipo VT_LPWSTR negli elementi PROPVARIANT recuperati). Se non vengono trovati oggetti del tipo richiesto, si tratta di una raccolta vuota (non NULL). Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Questa operazione è in genere veloce, perché il driver non deve eseguire un'enumerazione di contenuto completa e il numero di oggetti funzionali recuperati è in genere minore di 10. Se non vengono trovati oggetti del tipo richiesto, questo metodo non restituirà un errore, ma restituisce un insieme vuoto per ppObjectID.