Freigeben über


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