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

Artigo
07/16/2024

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

Um REFPROPERTYKEY que especifica qual recurso consultar.

[out] ppResourceAttributes

Ponteiro para um ponteiro de interface IPortableDeviceValues que contém pares PROPVARIANTPROPERTYKEY 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_ERRORe o PROPVARIANT membro conterá o HRESULT dessa falha específica.

Valor de retorno

O método retorna umHRESULT . Os valores possíveis incluem, mas não se limitam a, 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 hresult valores do tipo VT_ERROR no parâmetro ppResourceAttributes recuperado.
E_POINTER	Pelo menos um dos argumentos de ponteiro necessários foi NULL.

Observações

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
da Plataforma de Destino	Windows
cabeçalho	portabledeviceapi.h
biblioteca	PortableDeviceGUIDs.lib

Consulte também

interface IPortableDeviceResources

Compartilhar via