Funzione ClfsSetEndOfLog (wdm.h)
La routine ClfsSetEndOfLog tronca un flusso CLFS.
Sintassi
CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
[in] PLOG_FILE_OBJECT plfoLog,
[in] PCLFS_LSN plsnEnd
);
Parametri
[in] plfoLog
Puntatore a una struttura LOG_FILE_OBJECT che rappresenta un flusso CLFS. Questo flusso deve essere l'unico flusso di un log dedicato. Il chiamante ha ottenuto in precedenza questo puntatore chiamando ClfsCreateLogFile.
[in] plsnEnd
Puntatore a una struttura CLFS_LSN che fornisce l'LSN del record che deve diventare l'ultimo record del flusso. Deve essere l'LSN esatto di uno dei record nel flusso.
Valore restituito
ClfsSetEndOfLog restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Commenti
LSN fornito nel valore plsnEnd non viene convalidato. È responsabilità del chiamante fornire un LSN valido; vale a dire, uno che è l'esatto LSN di un record nel flusso.
Questo flusso rappresentato da plfoLog deve essere da un log dedicato. Questa routine non supporta flussi da log multiplexed.
Per una spiegazione dei concetti e della terminologia di CLFS, vedere Common Log File System.
La routine in modalità kernel ClfsSetEndOfLog è riservata per uso futuro e attualmente restituisce sempre STATUS_NOT_SUPPORTED. Tuttavia, la routine in modalità utente SetEndOfLog è attualmente supportata.
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 |