Compartir a través de


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

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.

Ejemplos

Para obtener un ejemplo de cómo usar este método, consulte Recuperación de los identificadores de objeto funcionales para un dispositivo.

Requisitos

   
Plataforma de destino Windows
Encabezado portabledeviceapi.h
Library PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceCapabilities (Interfaz)

Recuperación de los identificadores de objeto funcionales para un dispositivo

Recuperación de las funcionalidades de representación compatibles con un dispositivo