ADsPropCheckIfWritable, fonction (adsprop.h)
La fonction ADsPropCheckIfWritable détermine si un attribut peut être écrit.
Syntaxe
BOOL ADsPropCheckIfWritable(
[in] const PWSTR pwzAttr,
[in] const PADS_ATTR_INFO pWritableAttrs
);
Paramètres
[in] pwzAttr
Pointeur vers une mémoire tampon WCHAR terminée par NULL qui contient le nom de l’attribut.
[in] pWritableAttrs
Pointeur vers le tableau de structures ADS_ATTR_INFO retournées par ADsPropGetInitInfo.
Valeur retournée
Retourne une valeur différente de zéro si l’attribut se trouve dans la liste writable-attribute ou zéro dans le cas contraire. Retourne également zéro si pWritableAttrs a la valeur NULL.
Remarques
Pendant l’initialisation, une extension de feuille de propriétés doit déterminer si les attributs qu’elle peut modifier peuvent être écrits à l’aide d’ADsPropCheckIfWritable. Si un attribut ne peut pas être écrit, il doit être affiché en lecture seule et la possibilité de modifier la valeur de l’attribut doit être supprimée.
Il est possible qu’un utilisateur obtienne l’autorisation d’écriture, mais pas l’autorisation de lecture pour un attribut. Dans ce cas, l’opération de lecture de l’attribut échoue et il est possible que l’attribut soit remplacé. Par conséquent, il n’est pas recommandé d’accorder une autorisation d’écriture à un utilisateur, mais de révoquer l’autorisation de lecture sur un attribut.
N’utilisez pas cette fonction pour vérifier l’autorisation d’écriture pour les attributs dans une feuille de propriétés à sélection multiple. Il est probable que chaque objet de répertoire aura un jeu différent d’autorisations d’attribut accessible en écriture. L’extension de la feuille de propriétés doit s’appuyer sur le serveur qui retourne une erreur lors de la tentative d’écriture dans un objet spécifique dans un groupe sélectionné pour déterminer si les autorisations d’écriture pour cet objet sont refusées.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | adsprop.h |
| Bibliothèque | Dsprop.lib |
| DLL | Dsprop.dll |