IPropertyStorage::Enum

Creates an enumerator object designed to enumerate data of type STATPROPSTG, which contains information on the current property set. On return, this method supplies a pointer to the IEnumSTATPROPSTG pointer on this object.

HRESULT Enum(
  IEnumSTATPROPSTG ** ppenum  //Address of output variable that 
                              //receives the IEnumSTATPROPSTG 
                              //interface pointer
);
 

Parameters

ppenum
[out] Address of IEnumSTATPROPSTG* pointer variable that receives the interface pointer to the new enumerator object.

Return Values

This method supports the standard return value E_UNEXPECTED, as well as the following:

S_OK
A pointer to the enumerator has been retrieved.
STG_E_ACCESSDENIED
The requested access to the property storage object has been denied.
STG_E_INSUFFICIENTMEMORY
There is not sufficient memory to perform this operation.
STG_E_INVALIDPARAMETER
The parameter is invalid.
STG_E_READFAULT
Error reading storage.

Remarks

IPropertyStorage::Enum creates an enumeration object that can be used to iterate STATPROPSTG structures. On return, this method supplies a pointer to an instance of IEnumSTATPROPSTG interface on this objects whose methods you can call to obtain information on the current property set.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.

See Also

IEnumSTATPROPSTG, IEnumSTATPROPSTG -- Compound File Implementation