IEnumSTATPROPSETSTG Interface

IID_IEnumSTATPROPSETSTG

{0000013B-0000-0000-C000-000000000046}

The IEnumSTATPROPSETSTG interface iterates through an array of STATPROPSETSTG structures. The STATPROPSETSTG structures contain statistical data about the property sets managed by the current IPropertySetStorage instance.

The implementation defines the order in which the property sets are enumerated. Property sets that are present when the enumerator is created, and are not removed during the enumeration, will be enumerated only once. Property sets added or deleted while the enumeration is in progress may or may not be enumerated, but, if enumerated, will not be enumerated more than once.

Call IPropertySetStorage_Enum to return a pointer to IEnumSTATPROPSETSTG, the methods of which can then be called to enumerate STATPROPSETSTG structures so the application can manage its property sets.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IEnumSTATPROPSETSTG Methods

Description

Next

Gets a specified number of STATPROPSETSTG structures.

Skip

Skips a specified number of STATPROPSETSTG structures in the enumeration sequence.

Reset

Resets the enumeration sequence to the beginning of the STATPROPSETSTG structure array.

Clone

Creates an enumerator that contains the same enumeration state as the current STATPROPSETSTG structure enumerator.

QueryInterface

FUNCTION IEnumSTATPROPSETSTG_QueryInterface ( _

  BYVAL pthis AS DWORD PTR _

, BYREF riid AS GUID _

, BYREF ppvObj AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[0] USING IEnumSTATPROPSETSTG_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION IEnumSTATPROPSETSTG_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS LONG
  CALL DWORD @@pthis[1] USING IEnumSTATPROPSETSTG_AddRef (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

Release

FUNCTION IEnumSTATPROPSETSTG_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS DWORD
  CALL DWORD @@pthis[2] USING IEnumSTATPROPSETSTG_Release (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

STATPROPSETSTG Structure

TYPE STATPROPSETSTG
   fmtid AS GUID
   rclsid AS GUID
   grfFlags AS DWORD
   mtime AS FILETIME
   ctime AS FILETIME
   atime AS FILETIME
   dwOSVersion AS DWORD
END TYPE
 

Next

FUNCTION IEnumSTATPROPSETSTG_Next ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL celt AS DWORD _

, BYVAL rgelt AS DWORD _

, BYVAL pceltFetched AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IEnumSTATPROPSETSTG_Next (pthis, celt, rgelt, pceltFetched) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Skip

FUNCTION IEnumSTATPROPSETSTG_Skip ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL celt AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IEnumSTATPROPSETSTG_Skip (pthis, celt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Reset

FUNCTION IEnumSTATPROSETSTG_Reset ( _

  BYVAL pthis AS DWORD PTR _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IEnumSTATPROPSETSTG_Reset (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Clone

FUNCTION IEnumSTATPROPSETSTG_Clone ( _

  BYVAL pthis AS DWORD PTR _

, BYREF ppenum AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IEnumSTATPROPSETSTG_Clone (pthis, ppenum) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION