ClfsMgmtTailAdvanceFailure-Funktion (wdm.h)

  • Artikel

Die ClfsMgmtTailAdvanceFailure-Routine benachrichtigt die CLFS-Verwaltung, dass der Client den Protokollschwanz nicht voranbringen konnte.

Syntax

CLFSUSER_API NTSTATUS ClfsMgmtTailAdvanceFailure(
  [in] CLFS_MGMT_CLIENT Client,
  [in] NTSTATUS         Reason
);

Parameter

[in] Client

Ein Zeiger auf den Client. Dies ist der Wert, der durch einen Aufruf der ClfsMgmtRegisterManagedClient-Routine abgerufen wurde.

[in] Reason

Ein Wert, der angibt, warum der Tail des Protokolls nicht erweitert werden konnte.

Rückgabewert

Die ClfsMgmtTailAdvanceFailure-Routine gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die CLFS-Verwaltung hat die Benachrichtigung verarbeitet, dass der Tail des Protokolls nicht erweitert werden konnte.
STATUS_INVALID_PARAMETER
 Für den Clientparameter wurde ein NULL-Wert angegeben.
STATUS_INVALID_PARAMETER_1
 Der wert, der für den Client-Parameter angegeben wurde, stellt keinen gültigen Client dar.

Hinweise

Wenn ein Client den Tail seines Protokolls nicht auf oder über den angeforderten LSN hinaus erreichen kann, muss der Client die ClfsMgmtTailAdvanceFailure-Routine aufrufen, um anzugeben, dass er seinen Tail nicht voranbringen kann. Bis der Client seinen Tail wie angefordert verschiebt oder die ClfsMgmtTailAdvanceFailure-Routine aufruft, erhält der Client keine weiteren Anforderungen zum Verschieben des Tails.

Der Wert des Reason-Parameters wird als Wert des OperationStatus-Parameters an den Client zurückgegeben, wenn die ClfsLogGrowthCompleteCallback-Funktion aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile wdm.h (einschließen von Wdm.h)
Bibliothek Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Weitere Informationen

ClfsMgmtRegisterManagedClient