Metodo IPartsList::GetPart (devicetopology.h)

  • Articolo

Il metodo GetPart ottiene una parte dall'elenco delle parti.

Sintassi

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

Parametri

[in] nIndex

Numero di parte della parte da recuperare. Se l'elenco delle parti contiene n parti, le parti vengono numerate da 0 a n- 1. Chiamare il metodo IPartsList::GetCount per ottenere il numero di parti nell'elenco.

[out] ppPart

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IPart dell'oggetto part. Tramite questo metodo, il chiamante ottiene un riferimento contato all'interfaccia IPart . Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata GetPart ha esito negativo, *ppPart è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
E_INVALIDARG
 Il parametro nIndex non è compreso nell'intervallo.
E_POINTER
 Il puntatore ppPart è NULL.

Commenti

Per un esempio di codice che chiama il metodo GetPart , vedere l'implementazione della funzione SelectCaptureDevice in Topologie di dispositivo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IPart

Interfaccia IPartsList

IPartsList::GetCount