This method retrieves a STATSTG structure for this byte array object.
At a Glance
| Header file: | Objbase.h |
| Windows CE versions: | 2.0 and later |
Syntax
HRESULT Stat( STATSTG * pstatstg, DWORD grfStatFlag);
Parameters
pstatstg
[out] Pointer to a STATSTG structure in which this method places information about this byte array object. The pointer is NULL if an error occurs.
grfStatFlag
[in] Specifies whether this method should supply the pwcsName member of the STATSTG structure through values taken from the STATFLAG enumeration. If the STATFLAG_NONAME is specified, the pwcsName member of STATSTG is not supplied, thus saving a memory allocation operation. The other possible value, STATFLAG_DEFAULT, indicates that all STATSTG members be supplied.
Return Values
One of the values described in the following table is returned.
| Value | Description |
| S_OK | The STATSTG structure was successfully returned at the specified location. |
| E_OUTOFMEMORY | The STATSTG structure was not returned due to a lack of memory for the name member in the structure. |
| STG_E_ACCESSDENIED | The STATSTG structure was not returned because the caller did not have access to the byte array. |
| STG_E_INSUFFICIENTMEMORY | The STATSTG structure was not returned, due to a lack of memory. |
| STG_E_INVALIDFLAG | The value for the grfStateFlag parameter is not valid. |
| STG_E_INVALIDPOINTER | The value for the pStatStg parameter is not valid. |
Remarks
ILockBytes::Stat should supply information about the byte array object in a STATSTG structure.