SQLManageDataSources
de conformidade
Versão introduzida: ODBC 2.0
de Resumo do
SQLManageDataSources exibe uma caixa de diálogo com a qual os usuários podem configurar, adicionar e excluir fontes de dados nas informações do sistema.
Sintaxe
BOOL SQLManageDataSources(
HWND hwnd);
Argumentos
[Entrada] Identificador de janela pai.
Retorna
SQLManageDataSources retornará FALSE se hwnd não for um identificador de janela válido. Caso contrário, ele retornará TRUE.
Diagnostics
Quando SQLManageDataSources retorna FALSE, um valor *pfErrorCode associado pode ser obtido chamando SQLInstallerError. A tabela a seguir lista os valores *pfErrorCode que podem ser retornados por SQLInstallerError e explica cada um deles no contexto dessa função.
| *pfErrorCode | Erro | Descrição |
|---|---|---|
| ODBC_ERROR_GENERAL_ERR | Erro geral do instalador | Ocorreu um erro para o qual não houve nenhum erro específico do instalador. |
| ODBC_ERROR_REQUEST_FAILED | falha no de solicitação de |
Falha na chamada para ConfigDSN. |
| ODBC_ERROR_INVALID__HWND | Identificador de janela inválido | O argumento era inválido ou NULL. |
| ODBC_ERROR_OUT_OF_MEM | Memória insuficiente | O instalador não pôde executar a função devido à falta de memória. |
Gerenciando fontes de dados
CH23E
A caixa de diálogo exibe as fontes de dados listadas nas informações do sistema em três guias: DSN do Usuário, DSN do Sistema e DSN do Arquivo. Se o usuário clicar duas vezes em uma fonte de dados ou selecionar uma fonte de dados e clicar em Configurar, SQLManageDataSources chamadas ConfigDSN na DLL de configuração com a opção ODBC_CONFIG_DSN.
Se o usuário clicar em Adicionar, SQLManageDataSources exibirá a caixa de diálogo Criar Nova Fonte de Dados, mostrada na ilustração a seguir.
CH23F
A caixa de diálogo exibe uma lista de drivers instalados. Se o usuário clicar duas vezes em um driver ou selecionar um driver e clicar OK, SQLManageDataSources chamadas ConfigDSN na DLL de configuração e passar a opção ODBC_ADD_DSN.
Se o usuário selecionar uma fonte de dados e clicar em Remover, SQLManageDataSources perguntará se o usuário deseja excluir a fonte de dados. Se o usuário clicar Sim, SQLManageDataSources chamadas ConfigDSN na DLL de instalação com a opção ODBC_REMOVE_DSN.
A caixa de diálogo Criar Nova Fonte de Dados é usada para adicionar ou excluir uma fonte de dados do usuário, uma fonte de dados do sistema ou uma fonte de dados de arquivo.
DSNs de usuário
Os DSNs criados para usuários individuais serão chamados de DSNs de usuário, para distingui-los dos DSNs do Sistema. DSNs de usuário são registrados da seguinte maneira nas informações do sistema:
HKEY_CURRENT_USERS
SOFTWARE
ODBC
Odbc.ini
DSNs do sistema
A caixa de diálogo Criar Nova Fonte de Dados permite que você adicione uma fonte de dados do sistema ao computador local ou exclua uma ou defina a configuração para uma fonte de dados do sistema.
Uma fonte de dados configurada com um DSN (nome de fonte de dados do sistema) pode ser usada por mais de um usuário no mesmo computador. Ele também pode ser usado por um serviço de todo o sistema, que pode obter acesso à fonte de dados mesmo que nenhum usuário esteja conectado ao computador.
Um DSN do sistema é registrado na entrada HKEY_LOCAL_MACHINE nas informações do sistema, em vez de na entrada HKEY_CURRENT_USER. Ele não está vinculado a um usuário que faz logon com seu nome de usuário e senha específicos, mas pode ser usado por qualquer usuário desse computador ou por um serviço automático em todo o sistema. No entanto, o DSN do sistema está vinculado a um computador. Ele não dá suporte à capacidade de usar DSNs remotos entre computadores. Os DSNs do sistema são registrados da seguinte maneira nas informações do sistema:
HKEY_LOCAL_MACHINE software ODBC Odbc.ini
DSNs de arquivo
Uma fonte de dados de arquivo não tem um nome de fonte de dados, assim como uma fonte de dados do computador e não está registrada em nenhum usuário ou computador. As informações de conexão dessa fonte de dados estão contidas em um arquivo .dsn que pode ser copiado para qualquer computador. Uma fonte de dados de arquivo pode ser compartilhável, caso em que o arquivo .dsn reside em uma rede e pode ser usado simultaneamente por vários usuários na rede, desde que o usuário tenha o driver apropriado instalado. Uma fonte de dados de arquivo também pode ser incompartível, caso em que ela só pode ser usada em um único computador.
Para obter mais informações sobre fontes de dados de arquivo, consulte Conectando usando fontes de dados de arquivoou consulte SQLDriverConnect.
Gerenciando drivers
Se o usuário clicar na guia Drivers na caixa de diálogo Administrador da Fonte de Dados ODBC, SQLManageDataSources exibirá uma lista de drivers ODBC instalados no sistema, bem como informações sobre os drivers. A data exibida é a data de criação do driver, conforme mostrado na ilustração a seguir.
Opções de rastreamento
Se o usuário clicar na guia de Rastreamento
Ch23h
Se o usuário clicar em Iniciar Rastreamento Agora e clicar em OK, SQLManageDataSources habilita o rastreamento manualmente para todos os aplicativos em execução no computador.
Se o usuário especificar o nome de um arquivo de rastreamento na caixa de texto
Importante
O suporte para o Analisador do Visual Studio foi removido a partir do Windows 8 (o Analisador do Visual Studio foi incluído apenas em versões mais antigas do Visual Studio.). Para um mecanismo de solução de problemas alternativo, use o rastreamento BID.
Se o usuário clicar Iniciar o Analisador do Visual Studio e clicar em OK, o Analisador do Visual Studio estará habilitado. Ele permanece habilitado até que Parar do Analisador do Visual Studio seja clicado.
Para obter mais informações sobre o rastreamento, consulte Rastreamento. Para obter mais informações sobre as palavras-chave Trace e TraceFile, consulte subchave ODBC.
Funções relacionadas
| Para obter informações sobre | Ver |
|---|---|
| Criando fontes de dados | SQLCreateDataSource |