Partilhar via


Subchave ODBC

Os valores sob a subchave ODBC especificam opções de rastreamento ODBC. Estas opções são definidas através do separador Rastreio da caixa de diálogo ODBC Data Source Administrator apresentada por SQLManageDataSources. A subchave ODBC em si é opcional. O formato destes valores é o apresentado na tabela seguinte.

Nome Tipo de dados Data
Rastreio REG_SZ 0 | 1
Ficheiro de Traço REG_SZ caminho-ficheiro-de-rastreamento

Os valores têm os significados descritos na tabela seguinte.

Valor Meaning
Rastreio Se o valor Trace for definido para 1 quando uma aplicação chama SQLAllocHandle com a opção SQL_HANDLE_ENV, o traçado está ativado para a aplicação que chama.

Se a palavra-chave Trace for definida para 0 quando uma aplicação chama SQLAllocHandle com a opção SQL_HANDLE_ENV, o rastreamento fica desativado para a aplicação que chama. Este é o valor padrão.

Uma aplicação pode ativar ou desativar o rastreio com o atributo de ligação SQL_ATTR_TRACE. No entanto, fazê-lo não altera os dados para este valor.
Ficheiro de Traço Se o rastreio estiver ativado, o Gestor de Drivers escreve no ficheiro de rastreio especificado pelo valor TraceFile.

Se não for especificado nenhum ficheiro de rastreamento, o Gestor de Drivers escreve no ficheiro Sql.log na unidade atual. Este é o valor padrão.

O rastreamento deve ser usado apenas para uma única aplicação, ou cada aplicação deve especificar um ficheiro de traço diferente. Caso contrário, duas ou mais aplicações tentarão abrir o mesmo ficheiro de rastreamento ao mesmo tempo, causando um erro.

Uma aplicação pode especificar um novo ficheiro de rastreio com o atributo de ligação SQL_ATTR_TRACEFILE. No entanto, fazê-lo não altera os dados para este valor.

Por exemplo, suponha que o traçado está ativado e o ficheiro de traço é C:\Odbc.log. Os valores sob a subchave ODBC seriam os seguintes:

Trace : REG_SZ : 1  
TraceFile : REG_SZ : C:\ODBC.LOG