Método IPortableDeviceValues::GetAt (portabledevicetypes.h)

  • Artigo

Recupera um valor da coleção por um índice baseado em zero.

Sintaxe

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

Parâmetros

[in] index

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

[in, out] pKey

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

[in, out] pValue

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

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_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á uma das interfaces dispositivos portáteis do Windows (IPortableDeviceKeyCollection, IPortableDevicePropVariantCollection, IPortableDeviceValues ou IPortableDeviceValuesCollection). Nenhuma outra interface pode ser retornada por Dispositivos Portáteis do Windows.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho portabledevicetypes.h

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::GetStringValue