IStorage::SetStateBits

Stores up to 32 bits of state information in this storage object.

HRESULT SetStateBits(

DWORD grfStateBits,	//Specifies new values of bits
DWORD grfMask	//Specifies mask that indicates which bits are significant
);

Parameters
grfStateBits

[in]Specifies the new values of the bits to set. No legal values are defined for these bits; they are all reserved for future use and must not be used by applications. See the STGSTATE enumeration for a definition of these values.

grfMask

[in]A binary mask indicating which bits in grfStateBits are significant in this call. See the STGSTATE enumeration for a definition of these values.

Return Values
S_OK

The state information was successfully set.

STG_E_ACCESSDENIED

The caller does not have sufficient permissions for changing this storage object.

STG_E_INVALIDFLAG

The value for the grfStateBits or grfMask parameters are not valid.

STG_E_INVALIDPARAMETER

One of the parameters was invalid.

Comments
You can retrieve the state information with the IStorage::Stat method. When a storage object is first created, the value of this state information is zero. The values for the state bits are not defined currently and should not be used by applications.

The state set by this method is for external use only. The OLE-provided compound file implementation does not perform any action based on the state.