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