Compartilhar via

Método IPartsList::GetPart (devicetopology.h)

  • Artigo

O método GetPart obtém uma parte da lista de partes.

Sintaxe

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

Parâmetros

[in] nIndex

O número da parte a ser recuperada. Se a lista de partes contiver n partes, as partes serão numeradas de 0 a n– 1. Chame o método IPartsList::GetCount para obter o número de partes na lista.

[out] ppPart

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IPart do objeto part. Por meio desse método, o chamador obtém uma referência contada à interface IPart . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada GetPart falhar, *ppPart será NULL.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_INVALIDARG
 O parâmetro nIndex está fora do intervalo.
E_POINTER
 Pointer ppPart é NULL.

Comentários

Para obter um exemplo de código que chama o método GetPart , consulte a implementação da função SelectCaptureDevice em Topologias de Dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IPart Interface

IPartsList Interface

IPartsList::GetCount