Método IPortableDeviceCapabilities::GetSupportedFormatProperties (portabledeviceapi.h)
O método GetSupportedFormatProperties recupera as propriedades compatíveis com objetos de um formato especificado no dispositivo.
Sintaxe
HRESULT GetSupportedFormatProperties(
[in] REFGUID Format,
[out] IPortableDeviceKeyCollection **ppKeys
);
Parâmetros
[in] Format
Um REFGUID que especifica o formato do objeto. Para obter uma lista de formatos definidos por Dispositivos Portáteis do Windows, consulte Formatos de objeto.
[out] ppKeys
Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceKeyCollection que contém as propriedades com suporte para o formato especificado. Para obter uma lista de propriedades definidas por Dispositivos Portáteis do Windows, consulte Propriedades e Atributos. O chamador deve liberar essa interface quando terminar com ela.
Valor retornado
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
Código de retorno | Descrição |
---|---|
|
O método foi bem-sucedido. |
Comentários
Você pode especificar WPD_OBJECT_FORMAT_ALL para o parâmetro Format para recuperar o conjunto completo de atributos de propriedade.
Se um objeto não tiver um valor atribuído a uma propriedade específica ou se a propriedade tiver sido excluída, um dispositivo poderá não relatar a propriedade ao enumerar suas propriedades. Outro dispositivo pode relatar a propriedade, mas com uma cadeia de caracteres vazia ou um valor igual a zero. Para evitar essa inconsistência, você pode chamar esse método para aprender todas as propriedades que podem ser definidas em um objeto específico.
Requisitos
Plataforma de Destino | Windows |
Cabeçalho | portabledeviceapi.h |
Biblioteca | PortableDeviceGUIDs.lib |