SQLManageDataSources

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

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

構文

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

引数

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

戻り値

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

診断

SQLManageDataSources が FALSE を返す場合は、SQLInstallerError を呼び出すことによって、関連付けられた *pfErrorCode 値を取得できます。 次の表に、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 は セットアップ DLL の ConfigDSN を ODBC_CONFIG_DSN オプションで呼び出します。

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

ダイアログ ボックスには、インストールされているドライバーの一覧が表示されます。 ユーザーがドライバーをダブルクリックするか、ドライバーを選択して [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 データ ソースアドミニストレーター] ダイアログ ボックスの [ドライバー] タブをクリックすると、SQLManageDataSources には、システムにインストールされている ODBC ドライバーの一覧と、ドライバーに関する情報が表示されます。 表示される日付は、次の図に示すように、ドライバーの作成日です。

[トレース オプション]

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

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

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

重要

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

ユーザーが [ Visual Studio アナライザーの起動 ] をクリックし、[ OK] をクリックすると、Visual Studio Analyzer が有効になります。 [Visual Studio アナライザーの停止] がクリックされるまで有効なままです。

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

関連する関数

対象	解決方法については、
データ ソースの作成	SQLCreateDataSource