Funzione ClfsMgmtRegisterManagedClient (wdm.h)
La routine ClfsMgmtRegisterManagedClient crea un client che gestirà un log CLFS.
Sintassi
CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
[in] PLOG_FILE_OBJECT LogFile,
[in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
PCLFS_MGMT_CLIENT ClientCookie
);
Parametri
[in] LogFile
Puntatore a una struttura LOG_FILE_OBJECT che rappresenta il flusso di log CLFS gestito dal client creato da ClfsMgmtRegisterManagedClient .
[in] RegistrationData
Istanza della struttura CLFS_MGMT_CLIENT_REGISTRATION che contiene le funzioni che verranno usate per gestire il log.
ClientCookie
Il cookie restituito al chiamante per un uso futuro dell'API.
Valore restituito
La routine ClfsMgmtRegisterManagedClient restituisce uno dei valori NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
|
È stato creato un client per gestire il log. |
|
La gestione CLFS non è stata in grado di creare un client per gestire il log. |
|
Memoria insufficiente per completare l'operazione. |
|
Un parametro di input non è valido. |
Questa routine può restituire anche altri valori NTSTATUS.
Commenti
Il parametro Client fornito dalla routine ClfsMgmtRegisterManagedClient è un parametro obbligatorio per altre funzioni di gestione CLFS. È consigliabile archiviare questo valore per usarlo in un secondo momento.
Un'applicazione client deve essere pronta per chiamare la routine di callback non appena chiama la routine ClfsMgmtRegisterManagedClient .
Più client possono eseguire la registrazione con un flusso di log.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |