CreateClusterResource-Funktion (clusapi.h)

Artikel
02/23/2024

Erstellt eine Ressource in einem Cluster. Der PCLUSAPI_CREATE_CLUSTER_RESOURCE Typ definiert einen Zeiger auf diese Funktion.

Syntax

HRESOURCE CreateClusterResource(
  [in] HGROUP  hGroup,
  [in] LPCWSTR lpszResourceName,
  [in] LPCWSTR lpszResourceType,
  [in] DWORD   dwFlags
);

Parameter

[in] hGroup

Handle für die Gruppe , die die Ressource erhalten soll.

[in] lpszResourceName

Zeiger auf eine unicode-Zeichenfolge mit Null-Termin, die den Namen der neuen Ressource enthält. Der angegebene Name muss innerhalb des Clusters eindeutig sein.

[in] lpszResourceType

Zeiger auf den Typ der neuen Ressource. Der angegebene Typ muss im Cluster installiert sein.

[in] dwFlags

Bitmaske, die beschreibt, wie die Ressource dem Cluster hinzugefügt werden soll. Der dwFlags-Parameter kann auf einen der folgenden Werte festgelegt werden, die aus der CLUSTER_RESOURCE_CREATE_FLAGS-Enumeration aufgezählt werden.

CLUSTER_RESOURCE_DEFAULT_MONITOR (0)

Der Clusterdienst bestimmt den Ressourcenmonitor , dem die neue Ressource zugewiesen wird.

CLUSTER_RESOURCE_SEPARATE_MONITOR (1)

Bewirkt, dass der Clusterdienst einen separaten Ressourcenmonitor erstellt, der ausschließlich für die neue Ressource reserviert ist.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Ressourcenhandle zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Rufen Sie GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Rufen Sie CreateClusterResource nicht aus einer Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll