ClfsMgmtTailAdvanceFailure-Funktion (wdm.h)

Artikel
02/07/2025

Die ClfsMgmtTailAdvanceFailure Routine benachrichtigt die CLFS-Verwaltung, dass der Client den Tail des Protokolls 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 über 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 Client--Parameter wurde ein NULL- wert angegeben.
STATUS_INVALID_PARAMETER_1	Der für den Client Parameter bereitgestellte Wert stellt keinen gültigen Client dar.

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h)
Library	Clfs.lib
DLL-	Clfs.sys
IRQL-	<= APC_LEVEL

Siehe auch

ClfsMgmtRegisterManagedClient

Freigeben über