Funzione ClfsRemoveLogContainerSet (wdm.h)

Articolo
02/27/2024

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