Compartilhar via


Método IPortableDevicePropVariantCollection::GetAt

O método GetAt recupera um item da coleção por um índice baseado em zero.

Sintaxe

HRESULT GetAt(
  [in]  const DWORD       dwIndex,
  [out]       PROPVARIANT *pValue
);

Parâmetros

dwIndex [in]

DWORD que contém o índice baseado em zero do item a ser recuperado.

pValue [out]

Ponteiro para uma estrutura PROPVARIANT . O chamador é responsável por liberar essa memória chamando PropVariantClear.

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
S_OK
O método foi bem-sucedido.
E_POINTER
Um argumento de ponteiro necessário era NULL.
E_INVALIDARG
O índice que foi passado estava fora do intervalo.

Exemplos

Para obter um exemplo de como usar esse método, consulte Recuperando as categorias funcionais compatíveis com um dispositivo.

Requisitos

Requisito Valor
parâmetro
PortableDeviceTypes.h
Biblioteca
PortableDeviceGUIDs.lib

Confira também

IPortableDevicePropVariantCollection Interface

Recuperando um identificador de objeto de um identificador exclusivo persistente

Recuperando eventos de serviço com suporte

Recuperando formatos de serviço com suporte

Recuperando métodos de serviço com suporte

Recuperando os tipos de conteúdo compatíveis com um dispositivo

Recuperando as categorias funcionais compatíveis com um dispositivo

Recuperando os identificadores de objeto funcional para um dispositivo

Recuperando os recursos de renderização compatíveis com um dispositivo

Definindo propriedades para vários objetos