Funzione ClfsCloseAndResetLogFile (wdm.h)
La routine ClfsCloseAndResetLogFile rilascia tutti i riferimenti a un oggetto file di log specificato e contrassegna il flusso associato per la reimpostazione.
Sintassi
CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
[in] PLOG_FILE_OBJECT plfoLog
);
Parametri
[in] plfoLog
Puntatore a una struttura LOG_FILE_OBJECT per cui verranno rilasciati i riferimenti. Il chiamante ottenuto in precedenza questo puntatore chiamando ClfsCreateLogFile.
Valore restituito
ClfsCloseAndResetLogFile restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Osservazioni
ClfsCloseAndResetLogFile rilascia tutti i riferimenti, acquisiti da CLFS, all'oggetto file di log specificato. In genere, il client non avrà acquisito riferimenti aggiuntivi all'oggetto file di log. Tuttavia, se il client ha ottenuto riferimenti aggiuntivi, è responsabilità del client rilasciarli.
ClfsCloseAndResetLogFile fa sì che il conteggio dei riferimenti dell'oggetto file di log specificato venga azzerizzato, al momento in cui l'oggetto file di log viene chiuso (ovvero la relativa memoria viene deallocata). Il flusso rappresentato dall'oggetto file di log potrebbe non essere reimpostato, tuttavia, perché potrebbero essere presenti altri oggetti file di log che rappresentano lo stesso flusso. Il flusso viene reimpostato dopo la chiusura di tutti gli oggetti file di log che rappresentano il flusso, ad esempio tramite chiamate a ClfsCloseLogFileObject).
Un flusso di reimpostazione è simile a un flusso appena creato che non ha mai avuto record scritti in esso.
Al ritorno da questa routine, plfoLog non è valido.
È possibile chiamare ClfsCloseAndResetLogFile al massimo 124 volte per un determinato flusso.
Per una spiegazione dei concetti e della terminologia di CLFS, vedere Common Log File System.
Fabbisogno
| 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) |
| libreria | Clfs.lib |
| dll | Clfs.sys |
| IRQL | <= APC_LEVEL |