Condividi tramite


Interfaccia IEnumSTATPROPSTG (propidlbase.h)

L'interfaccia IEnumSTATPROPSTG scorre una matrice di strutture STATPROPSTG . Le strutture STATPROPSTG contengono dati statistici sulle proprietà in un set di proprietà. IEnumSTATPROPSTG ha gli stessi metodi di tutte le interfacce dell'enumeratore: Next, Skip, Reset e Clone.

L'implementazione definisce l'ordine in cui vengono enumerate le proprietà nel set. Le proprietà presenti quando viene creato l'enumeratore e che non vengono rimosse durante l'enumerazione verranno enumerate una sola volta. Le proprietà aggiunte o eliminate mentre l'enumerazione è in corso possono o meno essere enumerate, ma non verranno mai enumerate più volte.

Gli identificatori di proprietà riservati, le proprietà con ID proprietà 0 (dizionario), 1 (indicatore della tabella codici) o maggiori o uguali a 0x80000000 non vengono enumerate.

L'enumerazione di una proprietà nonsimple non indica necessariamente che la proprietà può essere letta correttamente tramite una chiamata a IPropertyStorage::ReadMultiple. Ciò è dovuto al fatto che il sovraccarico delle prestazioni del controllo dell'esistenza del flusso indiretto o dell'archiviazione è proibitivo durante l'enumerazione delle proprietà.

Ereditarietà

L'interfaccia IEnumSTATPROPSTG eredita dall'interfaccia IUnknown . IEnumSTATPROPSTG include anche questi tipi di membri:

Metodi

L'interfaccia IEnumSTATPROPSTG include questi metodi.

 
IEnumSTATPROPSTG::Clone

Il metodo IEnumSTATPROPSTG::Clone crea un enumeratore che contiene lo stesso stato di enumerazione dell'enumeratore della struttura STATPROPSTG corrente.
IEnumSTATPROPSTG::Next

Il metodo IEnumSTATPROPSTG::Next recupera un numero specificato di strutture STATPROPSTG, che seguono successivamente nella sequenza di enumerazione.
IEnumSTATPROPSTG::Reset

Il metodo IEnumSTATPROPSTG::Reset reimposta la sequenza di enumerazione all'inizio della matrice di struttura STATPROPSTG.
IEnumSTATPROPSTG::Skip

Il metodo IEnumSTATPROPSTG::Skip ignora il numero specificato di strutture STATPROPSTG nella sequenza di enumerazione.

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 propidlbase.h (include Propidl.h)

Vedi anche

Esempio EnumAll

IPropertyStorage::Enum