|
IEnumSTATSTG
The IEnumSTATSTG interface is used to enumerate through an array of STATSTG structures which contain statistical information about an open storage,
stream, or byte array object. IEnumSTATSTG shares the same methods as all enumerator interfaces: Next, Skip, Reset, and Clone.
IEnumSTATSTG is implemented to enumerate the elements of a storage object. Containers
usually call methods that return a pointer to IEnumSTATSTG so the container can manage its storage object and the elements within it.
Calls to the IStorage::EnumElements method returns a pointer to IEnumSTATDATA. The caller allocates an array of STATSTG structures and the IEnumSTATSTG methods fill in each structure with the statistics about one of the nested
elements in the storage object. If present, the lpszName member of the STATSTG structure requires additional memory allocations through the IMalloc interface, and the caller is responsible for freeing this memory, if it is
allocated, by calling the IMalloc::Free method. If the lpszName member is NULL, no memory is allocated, and, therefore, no memory needs to be
freed.
The prototypes of the member functions are as follows:
HRESULT Next(ULONG celt, STATSTG * rgelt, ULONG * pceltFetched)
HRESULT Skip(ULONG celt)
HRESULT Reset(void)
HRESULT Clone(IEnumSTATSTG ** ppenum)
See Also
CoGetMalloc, IEnumXXXX, IStorage::EnumElements, STATSTG
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
