Condividi tramite


Funzione DeleteLogFile (clfsw32.h)

Contrassegna un log per l'eliminazione. Il log viene effettivamente eliminato quando tutti gli handle, le aree di marshalling e i contesti di lettura nel log vengono chiusi. Se il log è un log fisico, i contenitori sottostanti vengono eliminati.

Quando un log è contrassegnato per l'eliminazione, le richieste di apertura di nuovi flussi di log client hanno esito negativo.

Nota Una funzione strettamente correlata è DeleteLogByHandle, che elimina un log quando viene specificato l'handle del file.

 

Sintassi

CLFSUSER_API BOOL DeleteLogFile(
  [in]           LPCWSTR pszLogFileName,
  [in, optional] PVOID   pvReserved
);

Parametri

[in] pszLogFileName

Nome del log.

Questo nome viene specificato durante la creazione del log usando CreateLogFile. L'esempio seguente identifica il formato da usare:

log:<nome log>[:: nome del flusso di log<>]

< nome del log> corrisponde a un percorso di file valido nel file system.

< nome del flusso di log> è il nome univoco di un flusso di log nel log.

Per altre informazioni, vedere tipi di log.

[in, optional] pvReserved

Questo parametro è riservato e deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per ottenere informazioni estese sull'errore, chiamare GetLastError. L'elenco seguente identifica i possibili codici di errore:

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2003 R2 [solo app desktop]
piattaforma di destinazione Finestre
intestazione clfsw32.h
libreria Clfsw32.lib
dll Clfsw32.dll

Vedere anche

funzioni comuni del file system di log

CreateLogFile

DeleteLogByHandle

SECURITY_ATTRIBUTES