Metodo IPartsList::GetPart (devicetopology.h)
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 |
|---|---|
|
Il parametro nIndex non è compreso nell'intervallo. |
|
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 |