Função AddLogContainerSet (clfsw32.h)
Adiciona vários contêineres de log ao log físico associado ao identificador de log se o processo de chamada tiver acesso ao identificador de log. Adicionar contêineres permite que um cliente aumente o tamanho de um log.
Sintaxe
CLFSUSER_API BOOL AddLogContainerSet(
[in] HANDLE hLog,
[in] USHORT cContainer,
[in, optional] PULONGLONG pcbContainer,
[in] LPWSTR *rgwszContainerPath,
[in, out, optional] LPVOID pReserved
);
Parâmetros
[in] hLog
O identificador para um log aberto obtido de CreateLogFile com permissões para adicionar um contêiner de log.
O arquivo pode ser dedicado ou multiplexado.
[in] cContainer
O número de contêineres na matriz rgwszContainerPath .
Esse valor deve ser diferente de zero. Um log deve ter pelo menos dois contêineres antes que qualquer E/S possa ser executada nele.
[in, optional] pcbContainer
O tamanho do contêiner, em bytes.
O tamanho mínimo é de 512 KB para logs normais e 1.024 KB para logs multiplexados. O tamanho máximo é de aproximadamente 4 gigabytes (GB).
Esse parâmetro será necessário se os contêineres estiverem sendo adicionados a um log recém-criado. Se um contêiner já estiver criado, esse parâmetro poderá ser NULL ou algum valor que seja pelo menos tão grande quanto o tamanho do primeiro contêiner.
Os tamanhos do contêiner de log são múltiplos do tamanho da região de log (512 KB). Quando você adiciona um contêiner a um novo arquivo, a função AddLogContainer arredonda o tamanho do contêiner até o próximo limite de 512 KB e retorna esse tamanho no valor apontado por pcbContainer.
Da mesma forma, se o log já tiver pelo menos um contêiner e o valor de *pcbContainer for pelo menos tão grande quanto o tamanho do contêiner atual, a função criará todos os contêineres com o tamanho interno atual e retornará esse tamanho em *pcbContainer.
[in] rgwszContainerPath
Uma matriz de nomes de caminho cContainer para contêineres.
Cada elemento na matriz é uma cadeia de caracteres largos que contém um caminho válido para o novo contêiner no volume de log.
[in, out, optional] pReserved
Reservado. Defina Reservado como NULL.
Retornar valor
Se a função for bem-sucedida, o valor retornado será diferente de zero, o que indica que todos os contêineres são adicionados com êxito ao log.
Se a função falhar, o valor retornado será zero, o que indica que nenhum dos contêineres será adicionado. Para obter informações de erro estendidas, chame GetLastError.
A lista a seguir identifica os possíveis códigos de erro:
Comentários
A função AddLogContainerSet não é atômica. Se a operação for interrompida, por exemplo, por um nome de caminho inválido, a chamada para AddLogContainerSet retornará uma falha, mas alguns contêineres poderão ter sido criados. Seu aplicativo deve se recuperar desse erro, por exemplo, determinando quais contêineres foram adicionados.
Como AddLogContainerSet adiciona mais de um contêiner, é mais eficiente do que fazer chamadas repetidas para AddLogContainer, que adiciona apenas um contêiner.
Os contêineres são criados e abertos em um modo não compactado e são inicializados com 0 (zeros) quando são criados.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | clfsw32.h |
| Biblioteca | Clfsw32.lib |
| DLL | Clfsw32.dll |