CreateClusterNotifyPortV2-Funktion (clusapi.h)

Erstellt oder ändert einen Benachrichtigungsport. Informationen zu Benachrichtigungsports finden Sie unter Empfangen von Clusterereignissen.

Syntax

HCHANGE CreateClusterNotifyPortV2(
  [in] HCHANGE                hChange,
  [in] HCLUSTER               hCluster,
  [in] NOTIFY_FILTER_AND_TYPE *Filters,
  [in] DWORD                  dwFilterCount,
  [in] DWORD_PTR              dwNotifyKey
);

Parameter

[in] hChange

Ein Handle für einen Benachrichtigungsport oder INVALID_HANDLE_VALUE, das angibt, dass ein neues Handle erstellt werden soll. Wenn der hChange-Parameter ein vorhandenes Handle ist, werden die ereignisse, die im dwFilter-Parameter angegeben sind, dem Benachrichtigungsport hinzugefügt.

[in] hCluster

Ein Handle für den Cluster , der dem Benachrichtigungsport zugeordnet werden soll, der durch den hChange-Parameter oder INVALID_HANDLE_VALUE identifiziert wird, was angibt, dass der Benachrichtigungsport keinem Cluster zugeordnet werden soll. Wenn der hChange-Parameter nicht auf INVALID_HANDLE_VALUE festgelegt ist, kann der hCluster-Parameter nicht auf INVALID_HANDLE_VALUE festgelegt werden.

[in] Filters

Ein Zeiger auf die NOTIFY_FILTER_AND_TYPE-Struktur , die den Typ der Benachrichtigungen angibt, die der Port akzeptieren kann.

[in] dwFilterCount

Die Anzahl der Filter, die durch den Filterparameter angegeben werden.

[in] dwNotifyKey

Ein benutzerdefinierter Wert, der dem Abruf von Benachrichtigungen vom Benachrichtigungsport zugeordnet werden soll. Der dwNotifyKey-Parameter wird von GetClusterNotifyV2 zurückgegeben, wenn ein Ereignis eines der in Filter angegebenen Typen auftritt.

Rückgabewert

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

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Weitere Informationen zum Fehler finden Sie unter GetLastError.

Anforderungen

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

Weitere Informationen

Failoverclusterverwaltungsfunktion