ClusterSetAccountAccess-Funktion (clusapi.h)
Updates eine Kontozugriffsliste (Account Access List, ACL) für einen Cluster.
Syntax
DWORD ClusterSetAccountAccess(
[in] HCLUSTER hCluster,
[in] LPCWSTR szAccountSID,
[in] DWORD dwAccess,
[in] DWORD dwControlType
);
Parameter
[in] hCluster
Ein Handle für den Cluster.
[in] szAccountSID
Die Sicherheits-ID (SID) oder der Kontoname für den neuen Kontozugriffseintrag (ACE).
[in] dwAccess
Die vom ACE kontrollierten Zugriffsrechte.
Mögliche Werte:
CLUSAPI_READ_ACCESS (0x00000001L)
Lesezugriff.
CLUSAPI_CHANGE_ACCESS (0x00000002L)
Das Konto kann verwendet werden, um Änderungen am Cluster vorzunehmen.
CLUSAPI_NO_ACCESS (0x0000004L)
Kein Zugriff.
CLUSAPI_ALL_ACCESS ((CLUSAPI_READ_ACCESS | CLUSAPI_CHANGE_ACCESS))
Das Konto kann zum Lesen und Ändern des Clusters verwendet werden.
[in] dwControlType
Der zu verwendende ACE-Typ.
Mögliche Werte:
CLUSTER_SET_ACCESS_TYPE_ALLOWED (0)
Fügt eine zulässige ACE hinzu.
CLUSTER_SET_ACCESS_TYPE_DENIED (1)
Fügt einen verweigerten ACE hinzu.
CLUSTER_DELETE_ACCESS_CONTROL_ENTRY (2)
Löscht alle ACEs für die SID.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| Kopfzeile | clusapi.h |
| Bibliothek | ClusAPI.lib |
| DLL | ClusAPI.dll |