IPropData::HrSetObjAccess
Applies to: Outlook 2013 | Outlook 2016
Sets the access level for the object.
HRESULT HrSetObjAccess(
ULONG ulAccess
);
Parameters
ulAccess
[in] A 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 value
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 the IPropData::HrSetPropAccess method, specifying the target property in the array pointed to by the lpPropTagArray parameter.
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.
You can also use HrSetObjAccess to prevent clients from creating new properties.