SQLManageDataSources

準拠
導入されたバージョン: ODBC 2.0

の概要
SQLManageDataSources 、ユーザーがシステム情報のデータ ソースを設定、追加、および削除できるダイアログ ボックスが表示されます。

構文

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

引数

hwnd を する
[入力]親ウィンドウ ハンドル。

収益

Hnd が有効なウィンドウ ハンドルでない場合、SQLManageDataSources は FALSE 返します。 それ以外の場合は TRUE を返します。

診断

SQLManageDataSources が FALSE を返す場合は、関連付けられた *pfErrorCode 値 SQLInstallerErrorを呼び出すことによって取得できます。 次の表に、SQLInstallerError によって返される *pfErrorCode 値の一覧を示し、この関数のコンテキストでそれぞれについて説明します。

*pfErrorCode	エラー	形容
ODBC_ERROR_GENERAL_ERR	インストーラーの一般的なエラー	特定のインストーラー エラーがないエラーが発生しました。
ODBC_ERROR_REQUEST_FAILED	要求 失敗しました	ConfigDSN の呼び出しに失敗しました。
ODBC_ERROR_INVALID__HWND	無効なウィンドウ ハンドル	hwnd 引数が無効または NULL です。
ODBC_ERROR_OUT_OF_MEM	メモリ不足	メモリ不足のため、インストーラーで関数を実行できませんでした。

データ ソースの管理

SQLManageDataSources 、次の図に示すように、最初に ODBC データ ソース アドミニストレーター ダイアログ ボックスが表示されます。

[

このダイアログ ボックスには、ユーザー DSN、システム DSN、ファイル DSNの 3 つのタブの下に、システム情報に一覧表示されるデータ ソースが表示されます。 ユーザーがデータ ソースをダブルクリックするか、データ ソースを選択して [の構成] をクリック 場合は、SQLManageDataSources、ODBC_CONFIG_DSN オプションを使用してセットアップ DLL の ConfigDSN 呼び出します。

ユーザーが [追加] をクリックすると、SQLManageDataSources 次の図に示すように、[新しいデータ ソース の作成] ダイアログ ボックス 表示されます。

CH23F[新しいデータ ソースの作成] ダイアログ ボックス

ダイアログ ボックスには、インストールされているドライバーの一覧が表示されます。 ユーザーがドライバーをダブルクリックするか、ドライバーを選択して [OK]クリックすると、SQLManageDataSources セットアップ DLL で ConfigDSN 呼び出し、ODBC_ADD_DSN オプションを渡 。

ユーザーがデータ ソースを選択して [の削除] クリックすると、SQLManageDataSources 、ユーザーがデータ ソースを削除するかどうかを確認します。 ユーザーが [はい]クリックした場合、SQLManageDataSources は、ODBC_REMOVE_DSN オプション 設定 DLL の ConfigDSN を呼び出します。

[新しいデータ ソースの作成] ダイアログ ボックスは、ユーザー データ ソース、システム データ ソース、またはファイル データ ソースを追加または削除するために使用します。

ユーザー DSN

個々のユーザー用に作成された DSN は、システム DSN と区別するためにユーザー DSN と呼ばれます。 ユーザー DSN は、システム情報に次のように登録されます。

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

システム DSN

[新しいデータ ソースの作成] ダイアログ ボックスでは、システム データ ソースをローカル コンピューターに追加したり、削除したり、システム データ ソースの構成を設定したりできます。

システム データ ソース名 (DSN) を使用して設定されたデータ ソースは、同じコンピューター上の複数のユーザーが使用できます。 また、システム全体のサービスで使用することもできます。これにより、ユーザーがコンピューターにログオンしていない場合でも、データ ソースにアクセスできます。

システム DSN は、HKEY_CURRENT_USER 項目ではなく、システム情報のHKEY_LOCAL_MACHINE項目に登録されます。 特定のユーザー名とパスワードでログオンする 1 人のユーザーには関連付けされませんが、そのコンピューターの任意のユーザーまたはシステム全体の自動サービスで使用できます。 ただし、システム DSN は 1 台のマシンに関連付けられています。 マシン間でリモート DSN を使用する機能はサポートされていません。 システム DSN は、システム情報に次のように登録されます。

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

ファイル DSN

ファイル データ ソースには、マシン データ ソースと同様にデータ ソース名がありません。また、1 人のユーザーまたはコンピューターには登録されません。 そのデータ ソースの接続情報は、任意のコンピューターにコピーできる .dsn ファイルに含まれています。 ファイル データ ソースは共有可能です。その場合、.dsn ファイルはネットワーク上にあり、ユーザーが適切なドライバーをインストールしている限り、ネットワーク上の複数のユーザーが同時に使用できます。 ファイル データ ソースは共有不可にすることもできます。その場合は、1 台のコンピューターでのみ使用できます。

ファイル データ ソースの詳細については、「ファイル データ ソースを使用した接続の 」を参照するか、「SQLDriverConnectする」を参照してください。

ドライバーの管理

ユーザーが [ODBC Data Source Administrator] ダイアログ ボックスの [ドライバー] タブをクリックすると、SQLManageDataSources 、システムにインストールされている ODBC ドライバーの一覧とドライバーに関する情報が表示されます。 表示される日付は、次の図に示すように、ドライバーの作成日です。

ch23g の [ODBC データ ソース管理者ドライバー] タブする

トレース オプション

ユーザーが [ODBC データ ソース アドミニストレーター] ダイアログ ボックスの [トレース] タブをクリックすると、次の図に示すように、SQLManageDataSources トレース オプションが表示されます。

ch23hODBC データ ソース管理者の [トレース] タブの

ユーザーが [今すぐトレースを開始] クリックし、[OK]クリックすると、SQLManageDataSources 、コンピューター上で現在実行中のすべてのアプリケーションに対して手動でトレースを有効にします。

ユーザーが ログ ファイルのパス テキスト ボックスでトレース ファイルの名前を指定し、[OK]をクリックすると、SQLManageDataSources 、システム情報の [ODBC] セクションの TraceFile キーワードを指定した名前に設定します。

大事な

Visual Studio Analyzer のサポートは Windows 8 以降で削除されました (Visual Studio Analyzer は以前のバージョンの Visual Studio にのみ含まれていました)。 代替のトラブルシューティング メカニズムとして、BID トレースを使用します。

ユーザーが [Visual Studio Analyzer の開始] クリックし、[OK]クリックすると、Visual Studio Analyzer が有効になります。 Visual Studio Analyzer の停止がクリックされるまで有効なままです。

トレースの詳細については、「トレースを参照してください。 Trace キーワードと TraceFile キーワードの詳細については、「ODBC サブキーの」を参照してください。

関連関数

詳細については、次の情報を参照してください。	見る
データ ソースの作成	SQLCreateDataSource