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.
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 |