Metodo IEnumVdsObject::Next (vdshwprv.h)

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Restituisce un numero specificato di oggetti nell'enumerazione, a partire dal punto corrente. Per altre informazioni, vedere Utilizzo degli oggetti di enumerazione.

Sintassi

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

Parametri

[in] celt

Numero di oggetti da restituire.

[out] ppObjectArray

Indirizzo di una matrice di puntatori IUnknown , che il VDS inizializza al momento della restituzione.

[out] pcFetched

Indirizzo di una ULONG, che il VDS inizializza in base al numero di oggetti in ppObjectArray.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice restituito Descrizione
S_OK
Il metodo ha restituito il numero specificato di oggetti. Il numero di oggetti restituiti segnalati in pcFetched è uguale a celt; restituisce tali oggetti.
S_FALSE
Il numero specificato di oggetti restituiti è maggiore del numero di oggetti rimanenti. Tutti gli oggetti rimanenti vengono restituiti e il numero di oggetti restituiti viene segnalato in pcFetched è minore di celt; restituisce tali oggetti.

Commenti

Per ottenere puntatori di interfaccia specifici dell'oggetto dai puntatori IUnknown restituiti nella matrice ppObjectArray , utilizzare il metodo IUnknown::QueryInterface .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vdshwprv.h
Libreria Uuid.lib

Vedi anche

IEnumVdsObject