Função AddLogContainer (clfsw32.h)
Adiciona um contêiner ao log físico associado ao identificador de log, se o processo de chamada tiver acesso de gravação ao arquivo .blf e a capacidade de criar arquivos no diretório de destino do contêiner.
Essa função é diferente de AddLogContainerSet, pois adiciona apenas um contêiner. Para adicionar vários contêineres, é mais eficiente usar AddLogContainerSet, que permite adicionar mais de um contêiner. Adicionar contêineres permite que um cliente aumente o tamanho de um log.
Sintaxe
CLFSUSER_API BOOL AddLogContainer(
[in] HANDLE hLog,
[in, optional] PULONGLONG pcbContainer,
[in] LPWSTR pwszContainerPath,
[in, out, optional] LPVOID pReserved
);
Parâmetros
[in] hLog
O identificador para um log aberto.
O identificador deve ser obtido de CreateLogFile com acesso de gravação ao log. O aplicativo cliente deve ter acesso de gravação ao arquivo .blf e a capacidade de criar arquivos no diretório de destino de um contêiner.
[in, optional] pcbContainer
O parâmetro opcional que especifica 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.
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] pwszContainerPath
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém um caminho válido para o novo contêiner em um volume de log.
[in, out, optional] pReserved
Reservado. Defina pReserved como NULL.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
A lista a seguir identifica os possíveis códigos de erro:
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 |