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

Vedere anche

CLFS_LSN

ClfsAdvanceLogBase

ClfsCreateLogFile

ClfsSetArchiveTail

ClfsSetEndOfLog

LOG_FILE_OBJECT