SQLManageDataSources

uyumluluk
Kullanıma Sunulan Sürüm: ODBC 2.0

Özeti
SQLManageDataSources, kullanıcıların sistem bilgilerinde veri kaynaklarını ayarlayıp ekleyebileceği ve silebileceği bir iletişim kutusu görüntüler.

Sözdizimi

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Bağımsız değişken

hwnd
[Giriş] Üst pencere tutamacı.

Döndürür

SQLManageDataSources, hwnd geçerli bir pencere tutamacı değilse YANLIŞ döndürür. Aksi takdirde TRUE döndürür.

Tanılama

SQLManageDataSources FALSE döndürdüğünde, SQLInstallerErrorçağrılarak ilişkili bir *pfErrorCode değeri alınabilir. Aşağıdaki tabloda, SQLInstallerError tarafından döndürülebilecek *pfErrorCode değerleri listelenir ve her biri bu işlev bağlamında açıklanmaktadır.

*pfErrorCode	Hata	Açıklama
ODBC_ERROR_GENERAL_ERR	Genel yükleyici hatası	Belirli bir yükleyici hatası olmayan bir hata oluştu.
ODBC_ERROR_REQUEST_FAILED	İstek başarısız oldu	ConfigDSN çağrısı başarısız oldu.
ODBC_ERROR_INVALID__HWND	Geçersiz pencere tutamacı	hwnd bağımsız değişkeni geçersiz veya NULL.
ODBC_ERROR_OUT_OF_MEM	Bellek yetersiz	Yükleyici, yetersiz bellek nedeniyle işlevi gerçekleştiremedi.

Veri Kaynaklarını Yönetme

SQLManageDataSources başlangıçta, aşağıdaki çizimde gösterildiği gibi ODBC Veri Kaynağı Yöneticisi iletişim kutusunu görüntüler.

CH23EODBC Veri Kaynağı Yöneticisi iletişim kutusunu

İletişim kutusu, sistem bilgilerinde listelenen veri kaynaklarını üç sekme altında görüntüler: Kullanıcı DSN, Sistem DSNve Dosya DSN. Kullanıcı bir veri kaynağına çift tıklarsa veya bir veri kaynağı seçerse veYapılandır'a tıklarsa, SQLManageDataSources kurulum DLL'sinde ODBC_CONFIG_DSN seçeneğiyle ConfigDSN çağırır.

KullanıcıEkle tıklarsa, SQLManageDataSources yeni veri kaynağı oluştur iletişim kutusunu görüntüler.

CH23FYeni Veri Kaynağı Oluştur iletişim kutusunu

İletişim kutusunda yüklü sürücülerin listesi görüntülenir. Kullanıcı bir sürücüye çift tıklarsa veya bir sürücü seçerse ve tamamtıklarsa, SQLManageDataSources kurulum DLL'sindeki ConfigDSN çağırır ve ODBC_ADD_DSN seçeneğini geçirir.

Kullanıcı bir veri kaynağı seçer veKaldır tıklarsa SQLManageDataSources kullanıcının veri kaynağını silmek isteyip istemediğini sorar. Kullanıcı Evettıklarsa SQLManageDataSources kurulum DLL'sindeki ConfigDSN ODBC_REMOVE_DSN seçeneğiyle çağırır.

Yeni Veri Kaynağı Oluştur iletişim kutusu kullanıcı veri kaynağı, sistem veri kaynağı veya dosya veri kaynağı eklemek veya silmek için kullanılır.

Kullanıcı DSN'leri

Tek tek kullanıcılar için oluşturulan DSN'ler, Sistem DSN'lerinden ayırt etmek için Kullanıcı DSN'leri olarak adlandırılır. Kullanıcı DSN'leri sistem bilgilerinde aşağıdaki gibi kaydedilir:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

Sistem DSN'leri

Yeni Veri Kaynağı Oluştur iletişim kutusu, yerel bilgisayarınıza bir sistem veri kaynağı eklemenize veya bir veri kaynağını silmenize ya da bir sistem veri kaynağının yapılandırmasını ayarlamanıza olanak tanır.

Sistem veri kaynağı adı (DSN) ile ayarlanmış bir veri kaynağı, aynı makinede birden fazla kullanıcı tarafından kullanılabilir. Ayrıca, makinede hiçbir kullanıcı oturum açmamış olsa bile veri kaynağına erişim elde eden sistem genelindeki bir hizmet tarafından da kullanılabilir.

Sistem DSN'leri, HKEY_CURRENT_USER girişi yerine sistem bilgilerindeki HKEY_LOCAL_MACHINE girişinde kaydedilir. Belirli bir kullanıcı adı ve parolası ile oturum açan bir kullanıcıya bağlı değildir, ancak bu makinenin herhangi bir kullanıcısı veya otomatik bir sistem genelinde hizmet tarafından kullanılabilir. Ancak Sistem DSN'sinin tek bir makineye bağlı olması gerekir. Makineler arasında uzak DSN'leri kullanma özelliğini desteklemez. Sistem DSN'leri, sistem bilgilerinde aşağıdaki gibi kaydedilir:

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

Dosya DSN'leri

Bir dosya veri kaynağının, makine veri kaynağı gibi bir veri kaynağı adı yoktur ve herhangi bir kullanıcı veya makineye kaydedilmez. Bu veri kaynağının bağlantı bilgileri, herhangi bir makineye kopyalanabilen bir .dsn dosyasında bulunur. Bir dosya veri kaynağı paylaşılabilir, bu durumda .dsn dosyası bir ağda bulunur ve kullanıcı uygun sürücü yüklü olduğu sürece ağda birden çok kullanıcı tarafından aynı anda kullanılabilir. Dosya veri kaynağı paylaşılamaz da olabilir; bu durumda yalnızca tek bir makinede kullanılabilir.

Dosya veri kaynakları hakkında daha fazla bilgi için bkz. Dosya Veri Kaynaklarını Kullanarak Bağlanmaveya bkz. sqldriverconnect.

Sürücüleri Yönetme

Kullanıcı ODBC Veri Kaynağı Yöneticisi iletişim kutusunda Sürücüleri sekmesine tıklarsa, SQLManageDataSources sistemde yüklü ODBC sürücülerinin listesini ve sürücülerle ilgili bilgileri görüntüler. Görüntülenen tarih, aşağıdaki çizimde gösterildiği gibi sürücünün oluşturma tarihidir.

İzleme Seçenekleri

Kullanıcı ODBC Veri Kaynağı Yöneticisi iletişim kutusunda İzleme sekmesine tıklarsa, SQLManageDataSources aşağıdaki çizimde gösterildiği gibi izleme seçeneklerini görüntüler.

Kullanıcı Şimdi İzlemeyi Başlat'e tıklarsa ve ardındantamam tıklarsa, SQLManageDataSources makinede çalışmakta olan tüm uygulamalar için izlemeyi el ile etkinleştirir.

Kullanıcı, Günlük dosyası Yolu metin kutusunda bir izleme dosyasının adını belirtir ve sonra Tamam'e tıklarsa SQLManageDataSources, sistem bilgilerinin [ODBC] bölümündeki TraceFile anahtar sözcüğünü belirtilen ada ayarlar.

Önemli

Visual Studio Analyzer desteği Windows 8'in başından itibaren kaldırıldı (Visual Studio Analyzer yalnızca Visual Studio'nun eski sürümlerine dahil edildi.) Alternatif sorun giderme mekanizması için BID izleme'yi kullanın.

Kullanıcı Visual Studio Analyzer'ı Başlat ve ardından Tamamtıklarsa, Visual Studio Çözümleyicisi etkinleştirilir. Visual Studio Analyzer'ı Durdur tıklanana kadar etkin kalır.

İzleme hakkında daha fazla bilgi için bkz. İzleme. İzleme ve TraceFile anahtar sözcükleri hakkında daha fazla bilgi için bkz. ODBC Alt Anahtarı.

İlgili İşlevler

Hakkında bilgi için	Görmek
Veri kaynakları oluşturma	SQLCreateDataSource