IStorage::SetStateBits method (objidl.h)

Article
02/22/2024

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

Syntax

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

Parameters

[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.

Remarks

The values for the state bits are not currently defined.

Requirements

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