Připojení pomocí SQLBrowseConnect

SQLBrowseConnect, podobně jako SQLDriverConnect, používá připojovací řetězec. Nicméně pomocí SQLBrowseConnect může aplikace vytvořit úplný připojovací řetězec za běhu. Aplikace tak může provádět dvě věci:

• Vytvořte vlastní dialogová okna, která zobrazí výzvu k zadání těchto informací, čímž si zachová kontrolu nad jeho "vzhledem a chováním".

• Prohledejte systém pro zdroje dat, které může používat konkrétní ovladač, případně postupně v několika krocích. Uživatel může například nejprve procházet síť pro servery a po výběru serveru procházet server pro databáze přístupné ovladačem.

Aplikace volá SQLBrowseConnect a předává připojovací řetězec, který se označuje jako připojovací řetězec požadavku procházení, který určuje ovladač nebo zdroj dat. Ovladač vrátí připojovací řetězec, který se označuje jako připojovací řetězec výsledku procházení, který obsahuje klíčová slova, možné hodnoty (pokud klíčové slovo přijímá samostatnou sadu hodnot) a uživatelsky přívětivé názvy. Aplikace vytvoří dialogové okno s uživatelsky přívětivými názvy a vyzve uživatele k zadání hodnot. Potom z těchto hodnot vytvoří nový připojovací řetězec žádosti o procházení a vrátí ho ovladači s dalším voláním SQLBrowseConnect.

Vzhledem k tomu, že připojovací řetězce se předávají tam a zpět, ovladač může poskytnout několik úrovní procházení vrácením nového připojovacího řetězce, když aplikace vrátí starý řetězec. Například při prvním volání aplikace SQLBrowseConnect může ovladač vrátit klíčová slova, která uživatele vyzve k zadání názvu serveru. Když aplikace vrátí název serveru, ovladač může vrátit klíčová slova, která uživatele vyzve k zadání databáze. Aplikace dokončí proces procházení po vrácení názvu databáze.

Pokaždé, když SQLBrowseConnect vrátí nový připojovací řetězec výsledků procházení, vrátí SQL_NEED_DATA jako návratový kód. Aplikace tak oznámí, že proces připojení není dokončený. Dokud sqlBrowseConnect nevrátí SQL_SUCCESS, připojení je ve stavu Potřebujete data a nelze ho použít pro jiné účely, například k nastavení atributu připojení. Aplikace může ukončit proces procházení připojení voláním SQLDisconnect.

Tato část obsahuje následující téma.

• Příklad procházení SQL Serveru