Skip to content

Latest commit

 

History

History
83 lines (63 loc) · 3.16 KB

nf-adsprop-adspropcheckifwritable.md

File metadata and controls

83 lines (63 loc) · 3.16 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:adsprop.ADsPropCheckIfWritable
ADsPropCheckIfWritable function (adsprop.h)
The ADsPropCheckIfWritable function determines if an attribute can be written.
ADsPropCheckIfWritable
ADsPropCheckIfWritable function [Active Directory]
_glines_adspropcheckifwritable
ad.adspropcheckifwritable
adsprop/ADsPropCheckIfWritable
ad\adspropcheckifwritable.htm
ad
ec0c3a70-58ad-4d92-85dc-63090b1fce94
12/05/2018
ADsPropCheckIfWritable, ADsPropCheckIfWritable function [Active Directory], _glines_adspropcheckifwritable, ad.adspropcheckifwritable, adsprop/ADsPropCheckIfWritable
adsprop.h
Windows
Windows Vista
Windows Server 2008
Dsprop.lib
Dsprop.dll
Windows
19H1
ADsPropCheckIfWritable
adsprop/ADsPropCheckIfWritable
c++
APIRef
kbSyntax
DllExport
Dsprop.dll
ADsPropCheckIfWritable

ADsPropCheckIfWritable function

-description

The ADsPropCheckIfWritable function determines if an attribute can be written.

-parameters

-param pwzAttr [in]

Pointer to a NULL-terminated WCHAR buffer that contains the name of the attribute.

-param pWritableAttrs [in]

Pointer to the array of ADS_ATTR_INFO structures returned by ADsPropGetInitInfo.

-returns

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

-remarks

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.

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.

-see-also

ADS_ATTR_INFO

ADsPropGetInitInfo