Funzione ClfsRemoveLogContainerSet (wdm.h)
La routine ClfsRemoveLogContainerSet rimuove atomicamente un set di contenitori da un log CLFS.
Sintassi
CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
[in] PLOG_FILE_OBJECT plfoLog,
[in] USHORT cContainers,
[in] PUNICODE_STRING rgwszContainerPath,
[in] BOOLEAN fForce
);
Parametri
[in] plfoLog
Puntatore a una struttura LOG_FILE_OBJECT che rappresenta il log CLFS da cui verranno rimossi i contenitori. Il chiamante ha ottenuto in precedenza questo puntatore chiamando ClfsCreateLogFile.
[in] cContainers
Numero di contenitori nel set. Questo è il numero di elementi nella matrice rgwszContainerPath .
[in] rgwszContainerPath
Puntatore a una matrice di strutture UNICODE_STRING , ognuna delle quali fornisce il nome del percorso per uno dei contenitori da rimuovere. Il numero di elementi nella matrice viene assegnato da cContainers. Un percorso specificato può essere assoluto o relativo al percorso del file di log di base per il log CLFS rappresentato da plfoLog. I percorsi relativi al file di log di base devono iniziare con CLFS_CONTAINER_RELATIVE_PREFIX, ovvero il valore letterale stringa (L"%BLF%\"). Le directory "." e ".." non sono consentite in un percorso relativo.
[in] fForce
Valore booleano che specifica se la rimozione del contenitore è forzata (TRUE) o differita (FALSE).
Valore restituito
ClfsRemoveLogContainerSet restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Commenti
La rimozione forzata dei contenitori (fForce = TRUE) ha esito positivo solo se i contenitori da rimuovere non fanno parte del log attivo.
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 |