Método IPortableDeviceResources::GetResourceAttributes (portabledeviceapi.h)

O método GetResourceAttributes recupera todos os atributos de um recurso especificado em um objeto .

Sintaxe

HRESULT GetResourceAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppResourceAttributes
);

Parâmetros

[in] pszObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID do objeto que hospeda o recurso.

[in] Key

Uma REFPROPERTYKEY que especifica qual recurso consultar.

[out] ppResourceAttributes

Ponteiro para um ponteiro de interface IPortableDeviceValues que contém pares PROPERTYKEY/PROPVARIANT que descrevem cada atributo e seu valor, respectivamente. Os tipos de valor dos valores de atributo variam. Se uma propriedade não puder ser retornada, o valor da propriedade retornada será VT_ERROR e o membro de códigoPROPVARIANT conterá o HRESULT dessa falha específica.

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	Todos os valores de atributo foram recuperados.
S_FALSE	Não foi possível recuperar um ou mais valores de atributo. Eles terão valores HRESULT do tipo VT_ERROR no parâmetro ppResourceAttributes recuperado.
E_POINTER	Pelo menos um dos argumentos de ponteiro necessários era NULL.

Comentários

Os atributos de recurso descrevem os direitos de acesso, o tamanho, o formato e outras informações relacionadas a um recurso. Por exemplo, os atributos de um recurso de anotação de áudio em um objeto de imagem podem especificar a taxa de bits, a contagem de canais e o formato de dados do áudio.

Requisitos

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

Confira também

IPortableDeviceResources Interface