CreateClusterResourceType-Funktion (clusapi.h)

Artikel
08/22/2023

Erstellt einen Ressourcentyp in einem Cluster. Der PCLUSAPI_CREATE_CLUSTER_RESOURCE_TYPE Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD CreateClusterResourceType(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszResourceTypeName,
  [in] LPCWSTR  lpszDisplayName,
  [in] LPCWSTR  lpszResourceTypeDll,
  [in] DWORD    dwLooksAlivePollInterval,
  [in] DWORD    dwIsAlivePollInterval
);

Parameter

[in] hCluster

Handle an den Cluster, um den neuen Ressourcentyp zu erhalten.

[in] lpszResourceTypeName

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

[in] lpszDisplayName

Zeiger auf den Anzeigenamen für den neuen Ressourcentyp. Während der Inhalt von lpszResourceTypeName den Ressourcentyp auf allen Clustern eindeutig identifizieren soll, sollte der Inhalt von lpszDisplayName ein lokalisierter Anzeigename für die Ressource sein, die für die Anzeige für Administratoren geeignet ist.

[in] lpszResourceTypeDll

Zeiger auf den vollqualifizierten Namen der Ressourcen-DLL für den neuen Ressourcentyp oder den Pfadnamen relativ zum Clusterverzeichnis.

[in] dwLooksAlivePollInterval

Der Standardmäßige Millisekundenwert, der als Abrufintervall verwendet werden soll, das von der LooksAlive-Funktion des neuen Ressourcentyps benötigt wird. Der dwLooksAlivePollInterval-Parameter wird verwendet, um die LooksAlivePollInterval-Eigenschaft des Ressourcentyps festzulegen.

[in] dwIsAlivePollInterval

Der Standardmäßige Millisekundenwert, der als Abrufintervall verwendet werden soll, das von der IsAlive-Funktion des neuen Ressourcentyps benötigt wird. Der dwIsAlivePollInterval-Parameter wird verwendet, um die IsAlivePollInterval-Eigenschaft des Ressourcentyps festzulegen.

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.

Hinweise

Die CreateClusterResourceType-Funktion definiert nur den Ressourcentyp in der Clusterdatenbank und registriert den Ressourcentyp beim Clusterdienst. Um den Prozess der Installation eines neuen Ressourcentyps in einem Cluster abzuschließen, müssen Entwickler die Ressourcen-DLLs und Clusteradministratorerweiterungs-DLLs für die neuen Typen auf jedem Knoten im Cluster installieren. Wenn der Clusteradministrator auf Systemen verwendet wird, die keine Mitgliedsknoten sind, müssen die Erweiterungs-DLLs auch auf diesen Systemen installiert werden.

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