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

O método GetPropertyAttributes recupera atributos de uma propriedade de objeto especificada em um dispositivo.

Sintaxe

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parâmetros

[in] pszObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID do objeto a ser consultado. Para especificar o dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] Key

Um REFPROPERTYKEY que especifica a propriedade para a qual consultar. Você pode recuperar uma lista de propriedades com suporte chamando GetSupportedProperties. Para obter uma lista de propriedades definidas por Dispositivos Portáteis do Windows, consulte Propriedades e Atributos.

[out] ppAttributes

Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceValues que contém os atributos de propriedade recuperados. Esses são pares PROPERTYKEY/value, em que PROPERTYKEY é a propriedade e o tipo de dados value depende da propriedade específica. O chamador deve liberar essa interface quando terminar de usá-la. Os atributos definidos por Dispositivos Portáteis do Windows podem ser encontrados na página Propriedades e Atributos .

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
S_OK	O método foi bem-sucedido e todos os atributos foram recuperados com êxito.
S_FALSE	Somente alguns valores de atributo podem ser recuperados. Outros não puderam e conterão um valor HRESULT do tipo VT_ERROR.
E_POINTER	Um argumento de ponteiro necessário era NULL.

Comentários

Os atributos de propriedade descrevem os direitos de acesso de uma propriedade, valores válidos e outras informações. Por exemplo, uma propriedade pode ter um valor WPD_PROPERTY_ATTRIBUTE_CAN_DELETE definido como False para evitar a exclusão e ter um intervalo de valores válidos armazenados como entradas individuais.

Exemplos

Para obter um exemplo de como usar esse método, consulte Definindo propriedades para um único objeto.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceProperties Interface

Definindo propriedades para um único objeto

Gravando propriedades de objeto de conteúdo