Interfaccia IEnumSTATPROPSTG (propidl.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, Resete Clone.
L'implementazione definisce l'ordine in cui vengono enumerate le proprietà nel set. Le proprietà presenti quando viene creato l'enumeratore e non vengono rimosse durante l'enumerazione verranno enumerate una sola volta. Le proprietà aggiunte o eliminate mentre l'enumerazione è in corso possono essere enumerate o meno, ma non verranno mai enumerate più volte.
identificatori di proprietà riservati, le proprietà con ID proprietà 0 (dizionario), 1 (indicatore tabella codici) o maggiore o uguale 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à.
Eredità
L'interfaccia IEnumSTATPROPSTG eredita dall'interfaccia IUnknown. IEnumSTATPROPSTG include anche questi tipi di membri:
Metodi
L'interfaccia IEnumSTATPROPSTG dispone di questi metodi.
|
IEnumSTATPROPSTG::Clone Il metodo IEnumSTATPROPSTG::Clone crea un enumeratore che contiene lo stesso stato di enumerazione dell'enumeratore di 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 strutture STATPROPSTG. |
|
IEnumSTATPROPSTG::Skip Il metodo IEnumSTATPROPSTG::Skip ignora il numero specificato di strutture STATPROPSTG nella sequenza di enumerazione. (IEnumSTATPROPSTG.Skip) |
Fabbisogno
| 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 | Finestre |
| intestazione | propidl.h (include Propidl.h) |