ClfsMgmtRegisterManagedClient, fonction (wdm.h)

  • Article

La routine ClfsMgmtRegisterManagedClient crée un client qui gérera un journal CLFS.

Syntaxe

CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
  [in] PLOG_FILE_OBJECT               LogFile,
  [in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
       PCLFS_MGMT_CLIENT              ClientCookie
);

Paramètres

[in] LogFile

Pointeur vers une structure de LOG_FILE_OBJECT qui représente le flux de journal CLFS que le client créé par ClfsMgmtRegisterManagedClient gérera.

[in] RegistrationData

Instance de la structure CLFS_MGMT_CLIENT_REGISTRATION qui contient les fonctions qui seront utilisées pour gérer le journal.

ClientCookie

Cookie que nous redonnons à l’appelant pour une utilisation ultérieure de l’API.

Valeur retournée

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

Code de retour Description
STATUS_SUCCESS
 Un client a été créé pour gérer le journal.
STATUS_UNSUCCESSFUL
 La gestion de CLFS n’a pas pu créer de client pour gérer le journal.
STATUS_INSUFFICIENT_RESOURCES
 La mémoire est insuffisante pour terminer l’opération.
STATUS_INVALID_PARAMETER
 Un paramètre d’entrée n’est pas valide.
 

Cette routine peut également retourner d’autres valeurs NTSTATUS.

Remarques

Le paramètre Client fourni par la routine ClfsMgmtRegisterManagedClient est un paramètre obligatoire pour les autres fonctions de gestion CLFS. Vous devez stocker cette valeur pour une utilisation ultérieure.

Une application cliente doit être prête pour que sa routine de rappel soit appelée dès qu’elle appelle la routine ClfsMgmtRegisterManagedClient .

Plusieurs clients peuvent s’inscrire avec un flux de journal.

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, Ntddk.h, Ntifs.h)
Bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT