Método IPortableDeviceValuesCollection::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]       IPortableDeviceValues **ppValues
);

dwIndex [in]: DWORD que especifica um índice baseado em zero na coleção.
ppValues [out]: Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceValues da coleção. O chamador é responsável por chamar Release nessa interface quando terminar com ele.

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	O índice baseado em zero que foi passado estava fora do intervalo.
E_POINTER	Um argumento de ponteiro necessário era NULL.
E_UNEXPECTED	A coleção contém um ponteiro NULL IPortableDeviceValues.

Todas as alterações feitas em valores na interface recuperada serão feitas na versão armazenada na coleção.

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