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 |