Platform SDK: MAPI

IPropData::HrSetObjAccess

The IPropData::HrSetObjAccess method sets the access level for the object.

Quick Info

See IPropData : IMAPIProp.

HRESULT HrSetObjAccess(
  ULONG ulAccess  
);
 

Parameters

ulAccess
[in] Bitmask of flags that specifies the object's access level. One of the following flags can be set:
IPROP_READONLY
Sets the object's access level to read-only.
IPROP_READWRITE
Sets the object's access level to read/write.

Return Values

S_OK
The object's access level was successfully set.

Remarks

The IPropData::HrSetObjAccess method sets the access level for an entire object, rather than for individual properties. HrSetObjAccess can be used to change the access level established when the object was created.

Notes to Callers

To set an access level on a property, first call HrSetObjAccess with the IPROP_READWRITE flag set in the ulAccess parameter to make the object modifiable. Then call IPropData::HrSetPropAccess, specifying the target property in the array pointed to by lpPropTagArray.

To create an object with properties that will be read-only to clients, create a read/write object, add the necessary properties, and then call HrSetObjAccess to change the object's access to read-only.

HrSetObjAccess can also be used to prevent clients from creating new properties.

See Also

IPropData::HrGetPropAccess, IPropData::HrSetPropAccess