Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains statistical information about an open storage, stream, or byte array object.

This structure is used in the IEnumSTATSTG, ILockBytes, IStorage, and IStreaminterfaces.

Syntax 

typedef struct tagSTATSTG {
  LPOLESTR 
pwcsName; 
  DWORD 
type;
  ULARGE_INTEGER 
cbSize; 
  FILETIME 
mtime; 
  FILETIME 
ctime; 
  FILETIME 
atime; 
  DWORD 
grfMode; 
  DWORD 
grfLocksSupported; 
  CLSID 
clsid; 
  DWORD 
grfStateBits; 
  DWORD 
reserved; 
} STATSTG;

Members

pwcsName

Points to a null-terminated string containing the name.

Space for this string is allocated by the method called and freed by the caller (refer to CoTaskMemFree).

You can specify not to return this member by specifying the STATFLAG_NONAME value when you call a method that returns a STATSTGstructure, except for calls to IEnumSTATSTG::Next, which provides no way to specify this value.

type

Indicates the type of storage object.

This is one of the values from the STGTYenumeration.

cbSize

Specifies the size in bytes of the stream or byte array.

mtime

Indicates the last modification time for this storage, stream, or byte array.

ctime

Indicates the creation time for this storage, stream, or byte array.

atime

Indicates the last access time for this storage, stream or byte array.

grfMode

Indicates the access mode specified when the object was opened.

This member is only valid in calls to Statmethods.

grfLocksSupported

Indicates the types of region locking supported by the stream or byte array. See the LOCKTYPESenumeration for the values available.

This member is not used for storage objects.

clsid

Indicates the class identifier for the storage object; set to CLSID_NULL for new storage objects.

This member is not used for streams or byte arrays.

grfStateBits

Indicates the current state bits of the storage object, that is, the value most recently set by the IStorage::SetStateBitsmethod.

This member is not valid for streams or byte arrays.

reserved

Reserved for future use.

Requirements

Header objidl.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also