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 ha 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.

Commenti

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 determina l'eliminazione del conteggio dei riferimenti dell'oggetto file di log specificato a zero, al momento della chiusura dell'oggetto file di log, 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.

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.

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)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Vedi anche

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile