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

El método GetSupportedFormatProperties recupera las propiedades admitidas por objetos de un formato especificado en el dispositivo.

Sintaxis

HRESULT GetSupportedFormatProperties(
  [in]  REFGUID                      Format,
  [out] IPortableDeviceKeyCollection **ppKeys
);

Parámetros

[in] Format

REFGUID que especifica el formato del objeto. Para obtener una lista de los formatos definidos por dispositivos portátiles de Windows, consulte Formatos de objeto.

[out] ppKeys

Dirección de una variable que recibe un puntero a una interfaz IPortableDeviceKeyCollection que contiene las propiedades admitidas para el formato especificado. Para obtener una lista de las propiedades definidas por dispositivos portátiles de Windows, vea Propiedades y atributos. 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

Puede especificar WPD_OBJECT_FORMAT_ALL para el parámetro Format para recuperar el conjunto completo de atributos de propiedad.

Si un objeto no tiene un valor asignado a una propiedad específica o si se eliminó la propiedad, es posible que un dispositivo no notifique la propiedad en absoluto al enumerar sus propiedades. Otro dispositivo puede notificar la propiedad, pero con una cadena vacía o un valor de cero. Para evitar esta incoherencia, puede llamar a este método para aprender todas las propiedades que puede establecer en un objeto específico.

Requisitos

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

Consulte también

IPortableDeviceCapabilities (Interfaz)

IPortableDeviceCapabilities::GetSupportedFormats