ADsPropCheckIfWritable, fonction (adsprop.h)

  • Article

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

Voir aussi

ADS_ATTR_INFO

ADsPropGetInitInfo