Metodo IEnumVdsObject::Next (vds.h)

Articolo
03/03/2024

[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 Uso 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 , inizializzando il VDS in base alla restituzione.

[out] pcFetched

Indirizzo di un oggetto ULONG, che inizializza il VDS sul 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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
S_OK	Il metodo ha restituito il numero specificato di oggetti. 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 , usare 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	vds.h
Libreria	Uuid.lib

Vedi anche

IEnumVdsObject

Condividi tramite