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 include il log dei moduli:nome del log fisico, dove 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 con multiplexing, il nome include il log del modulo:nome del log fisico::nome del flusso, dove nome del log fisico è il nome del percorso del log fisico nel file system sottostante e 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. Il modo in cui il contesto viene interpretato dipende dal valore passato in fLogOptionFlag.
[in] cbContext
Dimensioni, 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.
Osservazioni
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 di 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.
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 |