ClusterRegGetBatchNotification-Funktion (clusapi.h)

Ruft die Batchbenachrichtigung ab. Nachdem die Batchbenachrichtigung abgerufen wurde, wird sie über die ClusterRegBatchReadCommand-Funktion interpretiert. Nachdem die Batchbenachrichtigung verarbeitet wurde, muss sie über die Funktion ClusterRegBatchCloseNotification geschlossen werden.

Syntax

LONG ClusterRegGetBatchNotification(
  [in]  HREGBATCHPORT         hBatchNotify,
  [out] HREGBATCHNOTIFICATION *phBatchNotification
);

Parameter

[in] hBatchNotify

Das Handle für den Batchbenachrichtigungsport, der zuvor über die ClusterRegCreateBatchNotifyPort-Funktion geöffnet wurde.

[out] phBatchNotification

Ein Handle für die Batchbenachrichtigung, das alle Änderungen am oder unterhalb des relevanten Clusterregistrierungsschlüssels darstellt, die seit dem letzten Aufruf von ClusterRegGetBatchNotification oder seit dem Öffnen des Batchbenachrichtigungsports aufgetreten sind.

Rückgabewert

Die Funktion gibt einen der folgenden Systemfehlercodes zurück.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Vorgang wurde durchgeführt.
ERROR_INVALID_DATA 13 (0xD)	Die Daten sind ungültig.
ERROR_OUTOFMEMORY 14 (0xE)	Für diesen Vorgang ist nicht genügend Speicher verfügbar.
ERROR_GEN_FAILURE 31 (0x1F)	Ein an das System angeschlossenes Gerät funktioniert nicht.

Hinweise

Der PCLUSTER_REG_GET_BATCH_NOTIFICATION Typ definiert einen Zeiger auf diese Funktion.

Nur die Funktionen aus der Batchfunktionsgruppe, z. B . ClusterRegBatchAddCommand, generieren eine Registrierungsänderungsbenachrichtigung. Eine Registrierungsänderung, die keinen der Batchfunktionsbefehle verwendet, generiert keine Batchbenachrichtigung.

Anforderungen

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

Weitere Informationen

Clusterregistrierungszugriffsfunktionen

ClusterRegBatchCloseNotification

ClusterRegBatchReadCommand

ClusterRegCreateBatchNotifyPort