Funzione DeleteLogFile (clfsw32.h)

Contrassegna un log per l'eliminazione. Il log viene effettivamente eliminato quando vengono chiusi tutti gli handle, le aree di marshalling e i contesti di lettura nel log. 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 non riescono.

Nota Una funzione strettamente correlata è DeleteLogByHandle, che elimina un log quando viene fornito 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 quando si crea il log usando CreateLogFile. Nell'esempio seguente viene identificato il formato da usare:

Registro:<nome log[::<log stream name>>]

<nome> 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 informazioni dettagliate sull'errore, chiamare GetLastError. L'elenco seguente identifica i possibili codici di errore:

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione clfsw32.h
Libreria Clfsw32.lib
DLL Clfsw32.dll

Vedi anche

Funzioni comuni del file system di log

CreateLogFile

DeleteLogByHandle

SECURITY_ATTRIBUTES