IEnumSTATPROPSETSTG-Compound bestandsuitvoering

De implementatie van het samengestelde bestand van de IEnumSTATPROPSETSTG interface wordt gebruikt om een matrix van STATPROPSETSTG- structuren die statistische eigenschapsgegevens bevatten te inventariseren. De IPropertySetStorage implementatie beheert de statistische gegevens en is gekoppeld aan een huidig samengesteld bestandsopslagobject.

Wanneer te gebruiken

Roep de methoden van IEnumSTATPROPSETSTG- aan om STATPROPSETSTG- structuren op te sommen, die elk gegevens bevatten over een van de eigenschappensets die zijn gekoppeld aan het samengestelde bestandsopslagobject.

Opmerkingen

IEnumSTATPROPSETSTG::Next

Hiermee haalt u de volgende of meer STATPROPSETSTG- structuren op (het getal wordt opgegeven door de parameter celt). De STATPROPSETSTG elementen die worden geboden via een aanroep van de implementatie van het samengestelde bestand van IEnumSTATPROPSETSTG::Next de volgende regels volgen:

• Als IEnumSTATPROPSETSTG::Next STATPROPSETSTG.fmtid niet kan opgeven, worden nullen naar dat lid geschreven. Dit gebeurt wanneer de eigenschappenset geen vooraf gedefinieerde naam heeft (zoals \005SummaryInformation) en geen juridische waarde is.
• De eigenschappenset DocumentSummaryInformation en UserDefined is speciaal, omdat er mogelijk twee secties met eigenschappen zijn ingesteld. Deze eigenschappenset wordt beschreven in de sectie DocumentSummaryInformation en UserDefined Property Sets. De tweede sectie wordt de User-Defined Eigenschappen genoemd. Elke sectie wordt geïdentificeerd met een unieke indelings-id (FMTID). Wanneer IPropertySetStorage::Enum- wordt gebruikt om eigenschappensets te inventariseren, wordt de User-Defined eigenschappenset niet geïnventariseerd.

Notitie

Als u altijd een eigenschappenset maakt met behulp van IPropertySetStorage::Create, wordt een ongeldige FMTID geretourneerd voor de opslagnaam, IEnumSTATPROPSETSTG::Next een niet-nul, geldige FMTID voor de eigenschappenset [STATPROPSETSTG.fmtid].

 

• Het lid STATPROPSETSTG.grfFlags geeft niet noodzakelijkerwijs aan of de eigenschappenset ANSI is of niet. Als PROPSETFLAG_ANSI is ingesteld, is de eigenschappenset absoluut ANSI. Als PROPSETFLAG_ANSI duidelijk is, kan de eigenschappenset Unicode of niet-Unicode zijn, omdat het niet mogelijk is om te zien of het ANSI is zonder deze te openen.
• Het lid STATPROPSETSTG.grfFlags geeft aan of de eigenschappenset al dan niet eenvoudig is, dus de instelling van de vlag PROPSETFLAG_NONSIMPLE is altijd geldig.
• Als IEnumSTATPROPSETSTG::Next STATPROPSETSTG.clsid niet kan opgeven, wordt deze ingesteld op alle nullen (CLSID_NULL). In de com samengestelde bestands implementatie gebeurt dit wanneer de eigenschappenset eenvoudig is (de vlag PROPSETFLAG_NONSIMPLE niet is ingesteld) of niet-simple is, maar de CLSID niet expliciet is ingesteld. Voor niet-simple eigenschapssets is de CLSID die wordt ontvangen het object dat wordt onderhouden door de onderliggende IStorage.
• Als IEnumSTATPROPSETSTG::Next de tijdvelden [ctime, mtime, atime], wordt elke niet-ondersteunde tijd ingesteld op nullen. Bij de com-implementatie van samengestelde bestanden is het ophalen van deze waarden afhankelijk van het ophalen van deze waarden uit de onderliggende IStorage implementatie.

IEnumSTATPROPSETSTG::Skip

Hiermee wordt het aantal elementen overgeslagen dat is opgegeven in celt. Retourneert S_OK als het opgegeven aantal elementen wordt overgeslagen, retourneert S_FALSE als er minder elementen worden overgeslagen dan aangevraagd. Retourneert in elk ander geval de juiste fout.

IEnumSTATPROPSETSTG::Reset

Hiermee stelt u de cursor in op het begin van de opsomming. Als dit lukt, wordt S_OK geretourneerd, anders wordt STG_E_INVALIDHANDLE geretourneerd.

IEnumSTATPROPSETSTG::Clone

Hiermee kopieert u de huidige opsommingsstatus van deze opsomming.