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 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.
Osservazioni
Il valore 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 i flussi dai log con multiplexing.
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.
Fabbisogno
| 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 |