IPropertyStorage::Stat

Retrieves information about the current open property set.

HRESULT Stat(

STATPROPSTG* pstatpsstg

//Pointer to a filled-in STATPROPSETSTG structure

);

Parameters

pstatpsstg: [out] Pointer to a STATPROPSETSTG structure, which contains statistics about the current open property set.

Return Values

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

S_OK: Statistics were successfully obtained.
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.

Remarks

IPropertyStorage::Stat fills in and returns a pointer to a STATPROPSETSTG structure, containing statistics about the current property set. STATPROPSETSTG fields have the following meanings:

Field

Meaning

fmtid

The FMTID of this property set, specified when the property set was initially created.

clsid

The CLSID of this property set, specified when the property set was initially created and possibly modified thereafter with IPropertyStorage::SetClass. If not set, the value will be CLSID_NULL.

grfFlags

The flag values this set was created with. For details, see IPropertySetStorage::Create.

mtime

The time in UTC (FILETIME) at which this property set was last modified. Not all IPropertyStorage implementations maintain modification times on property sets; those who do not will return zero for this value.

ctime

The time in UTC (FILETIME) at which this property set was created. Not all IPropertyStorage implementations maintain creation times on property sets; those that do not will set this value to 0.

atime

The time in UTC (FILETIME) at which this property set was last accessed. Not all IPropertyStorage implementations maintain last access times on property sets; those that do not will set this value to 0.

See Also

STATPROPSETSTG structure, IPropertySetStorage::Enum, FILETIME structure

STATPROPSTG* pstatpsstg	//Pointer to a filled-in STATPROPSETSTG structure
);

Field	Meaning
fmtid	The FMTID of this property set, specified when the property set was initially created.
clsid	The CLSID of this property set, specified when the property set was initially created and possibly modified thereafter with IPropertyStorage::SetClass. If not set, the value will be CLSID_NULL.
grfFlags	The flag values this set was created with. For details, see IPropertySetStorage::Create.
mtime	The time in UTC (FILETIME) at which this property set was last modified. Not all IPropertyStorage implementations maintain modification times on property sets; those who do not will return zero for this value.
ctime	The time in UTC (FILETIME) at which this property set was created. Not all IPropertyStorage implementations maintain creation times on property sets; those that do not will set this value to 0.
atime	The time in UTC (FILETIME) at which this property set was last accessed. Not all IPropertyStorage implementations maintain last access times on property sets; those that do not will set this value to 0.