Metodo IMDSPEnumStorage::Next (mswmdm.h)
Il metodo Next restituisce un puntatore alle interfacce IMDSPStoragecelt successive.
Sintassi
HRESULT Next(
[in] ULONG celt,
[out] IMDSPStorage **ppStorage,
[out] ULONG *pceltFetched
);
Parametri
[in] celt
Numero di interfacce di archiviazione richieste.
[out] ppStorage
Matrice di puntatori di interfaccia IMDSPStoragecelt allocati dal chiamante. Restituisce NULL se non sono presenti altri supporti di archiviazione o si è verificato un errore. Se celt è maggiore di 1, il chiamante deve allocare memoria sufficiente per archiviare il numero di puntatori di interfaccia celt .
[out] pceltFetched
Puntatore a una variabile ULONG che riceve il conteggio delle interfacce restituite.
Valore restituito
Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:
- Codici di errore COM standard
- Codici di errore di Windows convertiti in valori HRESULT
- Codici di errore di Windows Media Gestione dispositivi
Commenti
Quando non sono presenti più interfacce di archiviazione o quando sono presenti meno interfacce di archiviazione rispetto a quelle richieste, il valore restituito da Next è S_FALSE. In questo caso, il parametro pceltFetched deve essere sottoposto a query per determinare il numero di interfacce, se presenti, restituite.
L'enumeratore di archiviazione potrebbe non riflettere l'effetto dell'inserimento e della rimozione dei supporti. In questi casi, il client deve ottenere un nuovo oggetto enumeratore.
Questo metodo deve essere implementato. Non deve restituire WMDM_E_NOTSUPPORTED o E_NOTIMPL. Per altre informazioni, vedere Interfacce obbligatorie e facoltative.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |