Compartir a través de


Método IPortableDeviceProperties::GetValues (portabledeviceapi.h)

El método GetValues recupera una lista de propiedades especificadas de un objeto especificado en un dispositivo.

Sintaxis

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Parámetros

[in] pszObjectID

Puntero a una cadena terminada en null que contiene el identificador del objeto que se va a consultar. Para especificar el dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pKeys

Puntero a una interfaz IPortableDeviceKeyCollection que contiene una o varias propiedades para consultar. Si es NULL, se recuperarán todas las propiedades. Consulte Propiedades y atributos para obtener una lista de propiedades definidas por dispositivos portátiles de Windows.

[out] ppValues

Dirección de una variable que recibe un puntero a una interfaz IPortableDeviceValues que contiene los valores de propiedad solicitados. Se devolverán como pares PROPERTYKEY/value, donde el tipo de datos del valor depende de la propiedad . Si un valor no se pudo recuperar por algún motivo, el tipo devuelto será VT_ERROR y contendrá un valor HRESULT que describa el error de recuperación. 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
Se recuperaron todos los valores de propiedad solicitados.
S_FALSE
No se pudieron recuperar uno o más valores de propiedad. Las propiedades del problema tendrán un valor HRESULT en el parámetro ppValues recuperado.

Requisitos

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

Consulte también

IPortableDeviceProperties (interfaz)

IPortableDeviceProperties::SetValues

Recuperación de propiedades content-object

Recuperar propiedades para un único objeto

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