Directory Services


The ADsPropCheckIfWritable function determines if an attribute can be written.

BOOL ADsPropCheckIfWritable(
  const PWSTR pwzAttr,
  const PADS_ATTR_INFO pWritableAttrs


[in] Pointer to a NULL-terminated WCHAR buffer that contains the name of the attribute.
[in] Pointer to the array of ADS_ATTR_INFO structures returned by ADsPropGetInitInfo.

Return Values

Returns non-zero if the attribute is found in the writable-attribute list or zero otherwise. Also returns zero if pWritableAttrs is NULL.


During initialization, a property sheet extension should determine if the attributes it can change can be written by using ADsPropCheckIfWritable. If an attribute cannot be written, it should be displayed as read-only and the ability to change the attribute value should be removed.

It is possible for a user to be granted write permission, but not read permission for an attribute. In this case, the attribute read operation fails and it is possible that the attribute could be overwritten. Consequently, it is not recommended to grant a user write permission, but revoke read permission on an attribute.

Windows XP: Do not use this function to verify the write permission for attributes in a multi-select property sheet. It is likely that each directory object will have a different set of writable attribute permissions. The property sheet extension should rely on the server returning an error when attempting to write to a specific object in a selected group to determine if write permissions for that object are denied.


Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Adsprop.h.
Library: Use DsProp.lib.

See Also