Funzione AddLogContainer (clfsw32.h)

Aggiunge un contenitore al log fisico associato all'handle di log, se il processo chiamante ha accesso in scrittura al file blf e alla possibilità di creare file nella directory di destinazione del contenitore.

Questa funzione è diversa da AddLogContainerSet, perché aggiunge solo un contenitore. Per aggiungere più contenitori, è più efficiente usare AddLogContainerSet, che consente di aggiungere più contenitori. L'aggiunta di contenitori consente a un client di aumentare le dimensioni di un log.

Sintassi

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

Parametri

[in] hLog

Handle in un log aperto.

L'handle deve essere ottenuto da CreateLogFile con accesso in scrittura al log. L'applicazione client deve avere accesso in scrittura al file blf e la possibilità di creare file nella directory di destinazione di un contenitore.

[in, optional] pcbContainer

Parametro facoltativo che specifica le dimensioni del contenitore, in byte.

La dimensione minima è 512 KB per i log normali e 1024 KB per i log multipli. La dimensione massima è di circa 4 gigabyte.

Questo parametro è obbligatorio se i contenitori vengono aggiunti a un nuovo log creato. Se un contenitore è già stato creato, questo parametro può essere NULL o un valore pari almeno alla dimensione del primo contenitore.

Le dimensioni dei contenitori di log sono più delle dimensioni dell'area di log (512 KB). Quando si aggiunge un contenitore a un nuovo file, la funzione AddLogContainer arrotonda le dimensioni del contenitore fino al limite 512 KB successivo e restituisce tale dimensione nel valore a cui punta pcbContainer.

Analogamente, se il log ha già almeno un contenitore e il valore di *pcbContainer è almeno maggiore della dimensione del contenitore corrente, la funzione crea tutti i contenitori con le dimensioni interne correnti e restituisce tale dimensione in *pcbContainer.

[in] pwszContainerPath

Puntatore a una stringa con terminazione null contenente un percorso valido per il nuovo contenitore in un volume di log.

[in, out, optional] pReserved

Riservato. Impostare pReserved 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. Per informazioni dettagliate sull'errore, chiamare GetLastError.

L'elenco seguente identifica i possibili codici di errore:

Requisiti

Vedi anche

AddLogContainerSet

Funzioni comuni del file system di log

CreateLogFile