implementazione del file IEnumSTATPROPSTG-Compound

  • Articolo

L'implementazione di file composta dell'interfaccia IEnumSTATPROPSTG viene usata per enumerare le proprietà, generando strutture STATPROPSTG che contengono dati di proprietà statistiche. L'implementazione di IPropertyStorage gestisce i dati statistici ed è associata a un oggetto di archiviazione file composto corrente.

Il costruttore nell'implementazione COM di IEnumSTATPROPSTG crea una classe che legge l'intero set di proprietà e crea una matrice statica che può essere condivisa quando viene chiamato IEnumSTATPROPSTG::Clone .

Utilizzo

Chiamare l'implementazione di file composta di IEnumSTATPROPSTG per enumerare le strutture STATPROPSTG che contengono dati sulle proprietà all'interno del set di proprietà corrente. Quando si usa l'implementazione di file composta delle interfacce di archiviazione delle proprietà, chiamare IPropertyStorage::Enum per restituire un puntatore a IEnumSTATPROPSTG per gestire l'oggetto di archiviazione delle proprietà e gli elementi al suo interno.

Commenti

IEnumSTATPROPSTG::Next

Ottiene la struttura successiva STATPROPSTG (il numero viene specificato dal parametro celt ). Restituisce S_OK in caso di esito positivo.

IEnumSTATPROPSTG::Skip

Ignora il numero di elementi specificati in celt. L'elemento successivo da enumerare tramite una chiamata a Next diventa quindi l'elemento dopo che gli elementi ignorati. Restituisce S_OK se gli elementi celt sono stati ignorati; restituisce S_FALSE se sono stati ignorati meno elementi celt .

IEnumSTATPROPSTG::Reset

Imposta il cursore sull'inizio dell'enumerazione. In caso di esito positivo, restituisce S_OK; in caso contrario, restituisce STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG::Clone

Usa il costruttore per IEnumSTATPROPSTG per creare una copia della matrice. Poiché la classe che costruisce la matrice statica contiene effettivamente l'oggetto , questa funzione aggiunge principalmente al conteggio dei riferimenti.

STATPROPSTG

IPropertyStorage::Enum