Condividi tramite


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

Vedi anche

IEnumSTATSTG

IStorage - Implementazione di file composti

STATSTG