Metodo IStorage::EnumElements (objidl.h)
Il metodo EnumElements recupera un puntatore a un oggetto enumeratore che può essere utilizzato per enumerare gli oggetti di archiviazione e flusso contenuti in questo oggetto di archiviazione.
Sintassi
HRESULT EnumElements(
[in] DWORD reserved1,
[in] void *reserved2,
[in] DWORD reserved3,
[out] IEnumSTATSTG **ppenum
);
Parametri
[in] reserved1
Riservato per utilizzi futuri; deve essere zero.
[in] reserved2
Riservato per uso futuro; deve essere NULL.
[in] reserved3
Riservato per utilizzi futuri; deve essere zero.
[out] ppenum
Puntatore alla variabile puntatore IEnumSTATSTG* che riceve il puntatore di interfaccia al nuovo oggetto enumeratore.
Valore restituito
Questo metodo può restituire uno di questi valori.
Codice restituito | Descrizione |
---|---|
S_OK | L'oggetto enumeratore è stato restituito correttamente. |
E_PENDING | Solo archiviazione asincrona: parte o tutti i dati dell'elemento non sono attualmente disponibili. |
STG_E_INSUFFICIENTMEMORY | Impossibile creare l'oggetto enumeratore a causa della mancanza di memoria. |
STG_E_INVALIDPARAMETER | Uno dei parametri non è valido. |
STG_E_REVERTED | L'oggetto di archiviazione è stato invalidato da un'operazione di ripristino sopra di essa nell'albero delle transazioni. |
Commenti
L'oggetto enumeratore restituito da questo metodo implementa l'interfaccia IEnumSTATSTG , una delle interfacce dell'enumeratore standard che contengono i metodi Next, Reset, Clone e Skip . IEnumSTATSTG enumera i dati archiviati in una matrice di strutture STATSTG .
L'oggetto di archiviazione deve essere aperto in modalità di lettura per consentire l'enumerazione dei relativi elementi.
L'oggetto enumeratore è autorizzato a enumerare gli elementi in qualsiasi ordine. L'oggetto enumeratore può anche trattare l'enumerazione come snapshot o per fare in modo che l'enumerazione rifletta lo stato corrente dell'oggetto di archiviazione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | objidl.h |
Libreria | Uuid.lib |
DLL | Ole32.dll |