Platform SDK: Active Directory, ADSI, and Directory Services |
Property modifications fail if the caller does not have sufficient rights. For write operations that batch modifications to multiple properties, the entire operation fails if the caller does not have the necessary rights to a single one of the modified properties. For example, you can make multiple IADs::Put calls to set multiple properties on an object. However, when you call IADs::SetInfo to write the new data from the local cache to the directory, SetInfo will fail if the caller does not have write access to all the modified properties. Similarly, IDirectoryObject::SetObjectAttributes fails to set any properties if the caller does not have access to all the properties being set. So you should batch multiple modify operations only if you know that all modifications will succeed. To determine the attributes of a directory object that the caller has the ability to modify, read the object's allowedAttributesEffective attribute.
If the caller does not have sufficient rights to modify a property, the following return codes may be returned:
E_ADS_PROPERTY_NOT_SET
E_ADS_PROPERTY_NOT_MODIFIED