Funzione ClfsDeleteLogFile (wdm.h)

La routine ClfsDeleteLogFile contrassegna un flusso CLFS per l'eliminazione.

Sintassi

CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
  [in]           PUNICODE_STRING puszLogFileName,
                 PVOID           pvReserved,
  [in]           ULONG           fLogOptionFlag,
  [in, optional] PVOID           pvContext,
  [in]           ULONG           cbContext
);

Parametri

[in] puszLogFileName

Puntatore a una struttura UNICODE_STRING che fornisce il nome del flusso CLFS da eliminare.

Se il flusso da eliminare è l'unico flusso di un log dedicato, il nome ha il nome log:physical log del modulo, dove il nome del log fisico è il nome del percorso del log fisico nel file system sottostante.

Se il flusso da eliminare è uno dei flussi di un log multiplexed, il nome ha il formato log:physical log name::stream name, dove physical log name è il nome del percorso del log fisico nel file system sottostante e il nome del flusso è il nome univoco del flusso da eliminare.

pvReserved

Riservato.

[in] fLogOptionFlag

Valore che indica la relazione tra CLFS e il componente che sta eliminando il log. Per un elenco dei valori possibili, vedere la descrizione del parametro fLogOptionFlag della routine ClfsCreateLogFile .

[in, optional] pvContext

Puntatore a un contesto. La modalità di interpretazione del contesto dipende dal valore passato in fLogOptionFlag.

[in] cbContext

Dimensione, in byte, del contesto a cui punta pvContext. Se pvContext non è NULL, questo parametro deve essere maggiore di zero.

Valore restituito

ClfsDeleteLogFile restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Common Log File System (CLFS) usa la struttura LOG_FILE_OBJECT per rappresentare i log. La funzione ClfsCreateLogFile restituisce un puntatore a LOG_FILE_OBJECT, che i client passano quindi ad altre funzioni CLFS.

I client CLFS non accedono direttamente ai membri di una struttura LOG_FILE_OBJECT. Per informazioni sui membri, vedere FILE_OBJECT.

ClfsDeleteLogFile contrassegna un flusso per l'eliminazione, ma non chiude gli oggetti file di log attualmente aperti. Per chiudere un oggetto file di log, chiamare ClfsCloseLogFileObject. Un flusso contrassegnato per l'eliminazione viene eliminato dopo la chiusura di tutti gli oggetti file di log associati al flusso.

Un flusso CLFS contrassegnato per l'eliminazione rifiuterà le richieste successive per aprire il flusso.

Il nome di un log CLFS fisico non include l'estensione blf.

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

ClfsCloseAndResetLogFile

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer