Funzione GetLogFileInformation (clfsw32.h)

Restituisce un buffer contenente i metadati relativi a un log specificato e allo stato corrente, definito dalla struttura CLFS_INFORMATION .

I dati ottenuti riflettono lo stato del log solo al momento in cui viene effettuata la chiamata. In genere, un client può continuare a memorizzare nella cache e usare i campi di questa struttura fino alla successiva aggiunta di record o scrittura dell'area di riavvio. In quel momento alcune informazioni diventano non aggiornate.

Sintassi

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

Parametri

[in] hLog

Handle per un log aperto ottenuto da una chiamata riuscita a CreateLogFile.

L'handle di log può fare riferimento a un log dedicato o multiplexed.

[in, out] pinfoBuffer

Puntatore a una struttura CLFS_INFORMATION allocata dall'utente che riceve i metadati del log.

[in, out] cbBuffer

Puntatore a una variabile che in input specifica le dimensioni, in byte, del buffer di metadati a cui punta pinfoBuffer.

Nell'output specifica il numero di byte effettivamente copiati in pinfoBuffer.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

L'elenco seguente identifica i possibili codici di errore:

Requisiti

Vedi anche

CLFS_INFORMATION

Funzioni comuni del file system di log

CreateLogFile

Recupero dell'LSN successivo