ClfsMgmtRegisterManagedClient, fonction (wdm.h)
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 |
|---|---|
|
Un client a été créé pour gérer le journal. |
|
La gestion de CLFS n’a pas pu créer de client pour gérer le journal. |
|
La mémoire est insuffisante pour terminer l’opération. |
|
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 |