IStorage::SetStateBits

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

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

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Objidl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.