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

  • Artículo

El método GetPart obtiene una parte de la lista de elementos.

Sintaxis

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

Parámetros

[in] nIndex

Número de pieza del elemento que se va a recuperar. Si la lista de partes contiene n partes, las partes se numeran de 0 a n– 1. Llame al método IPartsList::GetCount para obtener el número de partes de la lista.

[out] ppPart

Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz IPart del objeto part. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz IPart . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a GetPart , *ppPart es NULL.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_INVALIDARG
 El parámetro nIndex está fuera del intervalo.
E_POINTER
 El puntero ppPart es NULL.

Comentarios

Para obtener un ejemplo de código que llama al método GetPart , consulte la implementación de la función SelectCaptureDevice en Topologías de dispositivo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IPart (interfaz)

IPartsList (interfaz)

IPartsList::GetCount