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

Weitere Informationen

Clusterregistrierungszugriffsfunktionen