Funzione AddLogContainerSet (clfsw32.h)

Aggiunge più contenitori di log al log fisico associato all'handle di log, se il processo chiamante ha accesso all'handle di log. L'aggiunta di contenitori consente a un client di aumentare le dimensioni di un log.

Sintassi

CLFSUSER_API BOOL AddLogContainerSet(
  [in]                HANDLE     hLog,
  [in]                USHORT     cContainer,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     *rgwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

Parametri

[in] hLog

Handle per un log aperto ottenuto da CreateLogFile con autorizzazioni per aggiungere un contenitore di log.

Il file può essere dedicato o multiplexed.

[in] cContainer

Numero di contenitori nella matrice rgwszContainerPath .

Questo valore deve essere diverso da zero. Un log deve avere almeno due contenitori prima che sia possibile eseguire qualsiasi I/O.

[in, optional] pcbContainer

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 (GB).

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] rgwszContainerPath

Matrice di nomi di percorso cContainer per i contenitori.

Ogni elemento della matrice è una stringa di caratteri wide che contiene un percorso valido per il nuovo contenitore nel volume di log.

[in, out, optional] pReserved

Riservato. Impostare Riservato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero, che indica che tutti i contenitori vengono aggiunti correttamente al log.

Se la funzione ha esito negativo, il valore restituito è zero, che indica che nessuno dei contenitori viene aggiunto. Per informazioni dettagliate sull'errore, chiamare GetLastError.

L'elenco seguente identifica i possibili codici di errore:

Commenti

La funzione AddLogContainerSet non è atomica. Se l'operazione viene interrotta, ad esempio, da un nome di percorso non valido, la chiamata a AddLogContainerSet restituisce un errore, ma alcuni contenitori potrebbero essere stati creati. L'applicazione deve recuperare da questo errore, ad esempio determinando quali contenitori sono stati aggiunti.

Poiché AddLogContainerSet aggiunge più di un contenitore, è più efficiente di effettuare chiamate ripetute a AddLogContainer, che aggiunge solo un contenitore.

I contenitori vengono creati e aperti in modalità non compressa e vengono inizializzati con 0 (zero) quando vengono creati.

Requisiti

Vedi anche

AddLogContainer

Funzioni comuni del file system di log

SOVRAPPOSTA