Fonction ClfsMgmtTailAdvanceFailure (wdm.h)

  • Article

La routine ClfsMgmtTailAdvanceFailure informe la gestion CLFS que le client n’a pas pu avancer la fin du journal.

Syntaxe

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

Paramètres

[in] Client

Pointeur vers le client. Il s’agit de la valeur obtenue par le biais d’un appel à la routine ClfsMgmtRegisterManagedClient .

[in] Reason

Valeur qui indique pourquoi la fin du journal n’a pas pu être avancée.

Valeur retournée

La routine ClfsMgmtTailAdvanceFailure retourne l’une des valeurs NTSTATUS suivantes :

Code de retour Description
STATUS_SUCCESS
 La gestion CLFS a traité la notification indiquant que la fin du journal n’a pas pu être avancée.
STATUS_INVALID_PARAMETER
 Une valeur NULL a été fournie pour le paramètre Client .
STATUS_INVALID_PARAMETER_1
 La valeur fournie pour le paramètre Client ne représente pas un client valide.

Remarques

Si un client ne peut pas avancer la fin de son journal vers ou au-delà du LSN demandé, le client doit appeler la routine ClfsMgmtTailAdvanceFailure pour indiquer qu’il n’est pas en mesure d’avancer sa fin. Tant que le client ne déplace pas sa fin comme demandé ou appelle la routine ClfsMgmtTailAdvanceFailure , le client ne reçoit pas d’autres demandes de déplacement de sa fin.

La valeur du paramètre Reason est renvoyée au client en tant que valeur du paramètre OperationStatus lorsque la fonction ClfsLogGrowthCompleteCallback est appelée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (include Wdm.h)
Bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

ClfsMgmtRegisterManagedClient