Função CChkSGFiles.ErrInit

Aplica-se a: Exchange Server 2003 | Exchange Server 2007 | Exchange Server | 2010 Exchange Server 2013

Inicializa o objeto CChkSGFiles especificando os bancos de dados a serem verificados e o caminho e o nome base dos arquivos de log de transação a serem verificados. Os aplicativos devem chamar essa função imediatamente após chamar com êxito a função Novo .

Vitual ERRErrInit  
(
    Const WCHAR  * const rgwszDb[],
    Const ULONGcDB,
    __in_z const WCHAR  * const wszLogPath,
    __in_z const WCHAR  * const wszBaseName,
    Const ULONGulFlags = NO_FLAGS
);

Parâmetros

rgwszDb[]

Parâmetro de entrada. Uma matriz que especifica os bancos de dados a serem verificados. Cada elemento de matriz é uma cadeia de caracteres Unicode terminada em nulo que contém o caminho e o nome do arquivo de um banco de dados a ser verificado.

cDB

Parâmetro de entrada. O número de elementos de caminho de banco de dados válidos na matriz rgwszDb .

wszLogPath

Parâmetro de entrada. O caminho completo dos arquivos de log de transação a serem verificados, na forma de uma cadeia de caracteres Unicode terminada em nulo.

wszBaseName

Parâmetro de entrada. O nome base de três letras dos arquivos de log de transações do Exchange, na forma de uma cadeia de caracteres Unicode terminada em nulo.

ulFlags

Parâmetro de entrada opcional. Esse valor é reservado para uso futuro. O valor passado por esse parâmetro deve ser 0 (zero).

Valor de retorno

Um código de erro da enumeração ERR .

Comentários

A função ErrInit registra os bancos de dados e os arquivos de log que devem ser verificados. Essa função deve ser chamada depois que a nova função for chamada, mas antes que qualquer outra função ChkSGFiles seja chamada.

Você deve fornecer todos os nomes de banco de dados, o caminho do arquivo de log e o nome base como cadeias de caracteres Unicode terminadas em nulo.

Você pode verificar apenas os arquivos de banco de dados, apenas os arquivos de log ou os arquivos de banco de dados e de log. No entanto, ao chamar essa função, o aplicativo deve especificar pelo menos uma entidade a ser verificada. Passar 0 (zero) para cDB e NULL para wszLogPath retornará um erro.

Se o valor do cDB for diferente de 0 (zero), passar NULL para rgwszDb resultará em um erro. Para verificar os arquivos de banco de dados, o aplicativo deve fornecer os nomes do banco de dados.

Se NULL for passado para wszBaseName , mas wszLogPath* não for NULL, um erro será retornado. Um nome de base de arquivo de log sempre é necessário ao verificar arquivos de log.

Se você estiver usando CHKSGFILES em um aplicativo multithreaded, você deve chamar a função ErrInit na parte de thread único do aplicativo e pode chamá-la apenas uma vez para cada objeto CCheckSGFiles .

Requisitos

O Exchange 2013 inclui apenas uma versão de 64 bits da API CHKSGFILES.

A conta em que o aplicativo está em execução deve ter permissões de acesso de leitura para o banco de dados e arquivos de log que devem ser verificados.