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 |