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) |