Método IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)

Artículo
03/15/2023

El método GetFunctionalObjects recupera todos los objetos funcionales que coinciden con una categoría especificada en el dispositivo.

Sintaxis

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

Parámetros

[in] Category

REFGUID que especifica la categoría que se va a buscar. Esto puede ser WPD_FUNCTIONAL_CATEGORY_ALL para devolver todos los objetos funcionales.

[out] ppObjectIDs

Dirección de una variable que recibe un puntero a una interfaz IPortableDevicePropVariantCollection que contiene los identificadores de objeto de los objetos funcionales como cadenas (tipo VT_LPWSTR en los elementos PROPVARIANT recuperados). Si no se encuentra ningún objeto del tipo solicitado, será una colección vacía (no NULL). El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

Esta operación suele ser rápida, ya que el controlador no necesita realizar una enumeración de contenido completa y el número de objetos funcionales recuperados suele ser inferior a 10. Si no se encuentra ningún objeto del tipo solicitado, este método no devolverá un error, pero devuelve una colección vacía para ppObjectIDs.