Fonction ClusterSetAccountAccess (clusapi.h)
Mises à jour une liste d’accès aux comptes (ACL) pour un cluster.
Syntaxe
DWORD ClusterSetAccountAccess(
[in] HCLUSTER hCluster,
[in] LPCWSTR szAccountSID,
[in] DWORD dwAccess,
[in] DWORD dwControlType
);
Paramètres
[in] hCluster
Handle du cluster.
[in] szAccountSID
Identificateur de sécurité (SID) ou nom du compte de la nouvelle entrée d’accès au compte (ACE).
[in] dwAccess
Droits d’accès contrôlés par l’ACE.
Les valeurs possibles sont les suivantes :
CLUSAPI_READ_ACCESS (0x0000001L)
Accès en lecture.
CLUSAPI_CHANGE_ACCESS (0x00000002L)
Le compte peut être utilisé pour apporter des modifications au cluster.
CLUSAPI_NO_ACCESS (0x00000004L)
Pas d'accès.
CLUSAPI_ALL_ACCESS ((CLUSAPI_READ_ACCESS | CLUSAPI_CHANGE_ACCESS))
Le compte peut être utilisé pour lire et modifier le cluster.
[in] dwControlType
Type ACE à utiliser.
Les valeurs possibles sont les suivantes :
CLUSTER_SET_ACCESS_TYPE_ALLOWED (0)
Ajoute un ACE autorisé.
CLUSTER_SET_ACCESS_TYPE_DENIED (1)
Ajoute un ACE refusé.
CLUSTER_DELETE_ACCESS_CONTROL_ENTRY (2)
Supprime tous les AE pour le SID.
Valeur retournée
Si l’opération réussit, la fonction retourne ERROR_SUCCESS.
Si l’opération échoue, la fonction retourne un code d’erreur système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2016 |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |