IStorage::SetStateBits method (objidl.h)

The SetStateBits method stores up to 32 bits of state information in this storage object. This method is reserved for future use.


HRESULT SetStateBits(
  [in] DWORD grfStateBits,
  [in] DWORD grfMask


[in] grfStateBits

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.

[in] grfMask

A binary mask indicating which bits in grfStateBits are significant in this call.

Return value

This method can return one of these values.

Return code Description
S_OK The state information was successfully set.
E_PENDING Asynchronous Storage only: Part or all of the storage's data is currently unavailable.
STG_E_ACCESSDENIED The caller does not have enough permissions for changing this storage object.
STG_E_INVALIDFLAG The value for the grfStateBits or grfMask parameter is not valid.
STG_E_INVALIDPARAMETER One of the parameters was not valid.


The values for the state bits are not currently defined.


Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header objidl.h
Library Uuid.lib
DLL Ole32.dll

See also

IStorage - Compound File Implementation