Partilhar via


Subchave do ODBC

Os valores na subchave ODBC especificam opções de rastreamento ODBC. Essas opções são definidas por meio da guia Rastreamento da caixa de diálogo Administrador de fonte de dados ODBC exibida por SQLManageDataSources. A própria subchave ODBC é opcional. O formato desses valores é mostrado na tabela a seguir.

Nome Tipo de dados Dados
Trace REG_SZ 01 |
TraceFile REG_SZ tracefile-path

Os valores têm os significados descritos na tabela a seguir.

Valor Significado
Trace Se o valor de rastreamento for definido como 1 quando um aplicativo chamar SQLAllocHandle com a opção SQL_HANDLE_ENV, o rastreamento será habilitado para o aplicativo de chamada.

Se a palavra-chave Trace for definida como 0 quando um aplicativo chamar SQLAllocHandle com a opção SQL_HANDLE_ENV, o rastreamento será desabilitado para o aplicativo de chamada. Este é o valor padrão.

Um aplicativo pode habilitar ou desabilitar o rastreamento com o atributo de conexão SQL_ATTR_TRACE. No entanto, fazer isso não altera os dados para esse valor.
TraceFile Se o rastreamento estiver habilitado, o Gerenciador de Driver gravará no arquivo de rastreamento especificado pelo valor TraceFile.

Se nenhum arquivo de rastreamento for especificado, o Gerenciador de Driver gravará no arquivo Sql.log na unidade atual. Este é o valor padrão.

O rastreamento deve ser usado somente para um único aplicativo, ou cada aplicativo deve especificar um arquivo de rastreamento diferente. Caso contrário, dois ou mais aplicativos tentarão abrir o mesmo arquivo de rastreamento ao mesmo tempo, causando um erro.

Um aplicativo pode especificar um novo arquivo de rastreamento com o atributo de conexão SQL_ATTR_TRACEFILE. No entanto, fazer isso não altera os dados para esse valor.

Por exemplo, suponha que o rastreamento esteja habilitado e o arquivo de rastreamento seja C:\Odbc.log. Os valores na subchave ODBC seriam os seguintes:

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