Método IPortableDeviceCapabilities::GetFixedPropertyAttributes (portabledeviceapi.h)
O método GetFixedPropertyAttributes recupera os atributos de propriedade padrão para uma propriedade e um formato especificados. Atributos padrão são aqueles que têm o mesmo valor para todos os objetos do mesmo formato. Por exemplo, um dispositivo pode não permitir que os usuários modifiquem nomes de arquivo de vídeo; esse dispositivo retornaria WPD_PROPERTY_ATTRIBUTE_CAN_WRITE com um valor false para objetos formatados WMV. Atributos que podem ter valores diferentes para um formato ou atributos opcionais não são retornados.
Sintaxe
HRESULT GetFixedPropertyAttributes(
[in] REFGUID Format,
[in] REFPROPERTYKEY Key,
[out] IPortableDeviceValues **ppAttributes
);
Parâmetros
[in] Format
Um REFGUID que especifica o formato dos objetos de interesse. Para formatar valores guid , consulte Formatos de objeto.
[in] Key
Um REFPROPERTYKEY que especifica a propriedade da qual você deseja conhecer os atributos. As propriedades definidas por Dispositivos Portáteis do Windows são listadas em Propriedades e Atributos.
[out] ppAttributes
Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceValues que contém os atributos e seus valores. O chamador deve liberar essa interface quando terminar com ela.
Retornar valor
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.
Os atributos descrevem as propriedades. Os atributos de exemplo são WPD_PROPERTY_ATTRIBUTE_CAN_READ e WPD_PROPERTY_ATTRIBUTE_CAN_WRITE. Esse método não recupera atributos de recurso.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | portabledeviceapi.h |
| Biblioteca | PortableDeviceGUIDs.lib |