IStorage::SetStateBits

This method stores up to 32 bits of state information in this storage object.

At a Glance

Header file: Objidl.h
Windows CE versions: 2.0 and later

Syntax

HRESULT SetStateBits( DWORD grfStateBits, DWORD grfMask );

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.

grfMask

[in] Binary mask that indicates which bits in grfStateBits are significant in this call.

Return Values

One of the values described in the following table is returned.

Value 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. For more information see IFillLockBytes and Asynchronous Storage.
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.

Remarks

This interface is reserved for future use. The values for the state bits are not currently defined.