Artykuł
07/22/2011

Procedura SQLBrowseConnect

Procedura SQLBrowseConnect używa słowa kluczowe, które mogą zostać podzielone na trzy poziomy informacji o połączeniu.Dla każdego słowa kluczowego Poniższa tabela wskazuje, czy lista prawidłowych wartości jest zwracana i czy słowo kluczowe jest opcjonalne.

Poziom 1

Słowo kluczowe	Lista zwrócona?	Opcjonalne?	Opis
DSN	Brak	Nie	Nazwa źródło danych zwróconych przez SQLDataSources.Nie można użyć słowa kluczowego DSN, jeśli używany jest sterownik słowo kluczowe.
STEROWNIK	Brak	Nie	Microsoft ® SQL Server jest nazwa sterownika ODBC macierzystym klienta {SQL Server 10 macierzystym klienta}.Nie można użyć słowa kluczowego sterownik, jeśli zostanie użyte słowo kluczowe DSN.

Poziom 2

Słowo kluczowe	Lista zwrócona?	Opcjonalne?	Opis
SERWER	Tak	Nie	Nazwa serwera w sieci, na którym znajduje się źródło danych.Termin "(lokalny)" można wprowadzić jako serwer, w którym to przypadek lokalną kopię SQL Server mogą być używane, nawet wtedy, gdy jest to wersja niepodłączonych.
UID	Nie	Tak	Identyfikator logowania użytkownika.
PWD	Nie	Tak (zależy od użytkownika)	Hasło określone przez użytkownika.
APLIKACJA	Nie	Tak	Nazwa aplikacji telefonicznych procedura SQLBrowseConnect.
WSID	Nie	Tak	Identyfikator stacji roboczej.Zazwyczaj jest to nazwa sieciowa komputera, na którym działa aplikacja.

Poziom 3

Słowo kluczowe	Lista zwrócona?	Opcjonalne?	Opis
BAZY DANYCH	Tak	Tak	Nazwa SQL Server bazy danych.
JĘZYK	Tak	Tak	Krajowe język używany przez SQL Server.

Procedura SQLBrowseConnect ignoruje wartości przechowywane w definicji źródło danych ODBC słowa kluczowe bazy danych i języka.Jeśli określono bazy danych lub języka w połączeniu z ciąg przekazany do procedura SQLBrowseConnect jest nieprawidłowy, procedura SQLBrowseConnect zwraca SQL_NEED_DATA i atrybuty połączenia poziom 3.

Następujące atrybuty, które są ustawiane przez wywołanie Procedura SQLSetConnectAttr, ustalenia zestaw wyników zwrócone przez procedura SQLBrowseConnect.

Attribute	Opis
SQL_COPT_SS_BROWSE_CONNECT	Jeśli jest zestaw do SQL_MORE_INFO_YES w SQL Server 2000 i nowszych, procedura SQLBrowseConnect zwraca ciąg rozszerzone właściwości serwera. Oto przykład dłuższy ciąg zwracany przez procedura SQLBrowseConnect w SQL Server 2000: `ServerName\InstanceName;Clustered:No;Version:8.00.131` W tym ciąg należy oddzielić średnikami różnymi informacjami o serwerze.Użyj przecinków do oddzielenia wystąpień inny serwer.
SQL_COPT_SS_BROWSE_SERVER	Jeżeli określono nazwa serwera, procedura SQLBrowseConnect spowoduje zwrócenie informacji dla określonego serwera.Jeśli jest SQL_COPT_SS_BROWSE_SERVER zestaw wartość null, procedura SQLBrowseConnect zwraca informacje dla wszystkich serwerów w domenie. Uwaga: Ze względu na problemy sieciowe procedura SQLBrowseConnect nie może otrzymywać czasie odpowiedzi od wszystkich serwerów.Dlatego listy serwery zwracane mogą się różnić dla każdego żądania.
SQL_COPT_SS_BROWSE_CACHE_DATA	Gdy atrybut SQL_COPT_SS_BROWSE_CACHE_DATA jest zestaw do SQL_CACHE_DATA_YES, można pobrać danych fragmentów długość buforu nie jest wystarczająco duży, aby pomieścić wynik.Ta długość jest określona w BufferLength argument SQLBrowseConnect. SQL_NEED_DATA jest zwracana, gdy dostępne jest więcej danych.SQL_SUCCESS jest zwracana, gdy nie ma więcej danych do pobrania. Wartość domyślna to SQL_CACHE_DATA_NO.

Attribute

Opis

SQL_COPT_SS_BROWSE_CONNECT

Jeśli jest zestaw do SQL_MORE_INFO_YES w SQL Server 2000 i nowszych, procedura SQLBrowseConnect zwraca ciąg rozszerzone właściwości serwera.

Oto przykład dłuższy ciąg zwracany przez procedura SQLBrowseConnect w SQL Server 2000:

ServerName\InstanceName;Clustered:No;Version:8.00.131

W tym ciąg należy oddzielić średnikami różnymi informacjami o serwerze.Użyj przecinków do oddzielenia wystąpień inny serwer.

SQL_COPT_SS_BROWSE_SERVER

Jeżeli określono nazwa serwera, procedura SQLBrowseConnect spowoduje zwrócenie informacji dla określonego serwera.Jeśli jest SQL_COPT_SS_BROWSE_SERVER zestaw wartość null, procedura SQLBrowseConnect zwraca informacje dla wszystkich serwerów w domenie.

Uwaga:

Ze względu na problemy sieciowe procedura SQLBrowseConnect nie może otrzymywać czasie odpowiedzi od wszystkich serwerów.Dlatego listy serwery zwracane mogą się różnić dla każdego żądania.

SQL_COPT_SS_BROWSE_CACHE_DATA

Gdy atrybut SQL_COPT_SS_BROWSE_CACHE_DATA jest zestaw do SQL_CACHE_DATA_YES, można pobrać danych fragmentów długość buforu nie jest wystarczająco duży, aby pomieścić wynik.Ta długość jest określona w BufferLength argument SQLBrowseConnect.

SQL_NEED_DATA jest zwracana, gdy dostępne jest więcej danych.SQL_SUCCESS jest zwracana, gdy nie ma więcej danych do pobrania.

Wartość domyślna to SQL_CACHE_DATA_NO.