Compartilhar via


Método IPortableDeviceValues::GetAt

O método GetAt recupera um valor da coleção usando o índice baseado em zero fornecido.

Sintaxe

HRESULT GetAt(
  [in]      const DWORD       index,
  [in, out]       PROPERTYKEY *pKey,
  [in, out]       PROPVARIANT *pValue
);

Parâmetros

index [in]

Um DWORD que especifica um índice baseado em zero na coleção.

pKey [in, out]

Um ponteiro PROPERTYKEY opcional que recupera a chave do item especificado.

pValue [in, out]

Um PROPVARIANT opcional que recupera o valor do item especificado. O chamador deve liberar a memória chamando PropVariantClear quando terminar com ele.

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_INVALIDARG
Um número de índice inválido foi especificado.

Comentários

Se uma propriedade indicar um valor do tipo VT_UNKNOWN, a propriedade será um dos Dispositivos Portáteis do Windows (IPortableDeviceKeyCollection, IPortableDeviceValuesCollection, IPortableDeviceValues ou IPortableDevicePropvariantCollection). Nenhuma outra interface pode ser retornada por Dispositivos Portáteis do Windows.

Requisitos

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

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetStringValue