ODBC_connect

t_pconnection ODBC_connect(const char * dsn, const char * uid, const char * pwd, void * window_handle);
function ODBC_connect(dsn : PChar; uid : PChar; pwd : PChar; window_handle : Pointer) : t_pconnection;

Parametry

dsn

jméno ODBC zdroje dat

uid

uživatelské jméno pro přihlášení k ODBC zdroji dat

pwd

heslo pro přihlášení k ODBC zdroji dat

window_handle

handle rodičovského okna pro zobrazení přihlašovacího dialogu

Od verze

9.5

Popis

Funkce vytváří nové ODBC spojení použitelné pro přenos dat funkcí Data_transport do a z tabulek v ODBC zdroji dat nebo pro funkce z XML API pro přenos z a do ODBC zdrojů dat.

Parametr dsn udává jméno zdroje dat registrovaného v operačním systému jako systémový nebo uživatelský zdroj dat.

Parametry uid a pwd umožňují připojení se na tento zdroj dat. Některé zdroje dat tyto údaje nepožadují. Pokud se při volání této funkce nespecifikuje uživatelské jméno nebo heslo, lze jako hodnotu parametru uvést NULL (nil).

Je-li parametr window_handle roven NULL (nil), pak funkce pracuje neinteraktivně a pokusí se vytvořit spojení na základě hodnot předaných v parametrech. Pokud tento parametr udává handle okna, pak volání funkce může otevřít dialog ODBC driveru, aby od uživatele získala chybějící údaje potřebné k připojení se na zdroj dat.

Návratová hodnota

Funkce vrací ukazatel na strukturu ODBC spojení, pokud se ji podaří spojení vytvořit. Tuto strukturu je třeba později uvolnit voláním funkce ODBC_disconnect.

Pokud se spojení nevytvořilo, funkce vrací NULL (nil). Příčinou může být například:

na počítači není instalována podpora ODBC;
zadaný zdroj dat dsn není registrován;
údaje zadané v paramtrech uid a pwd nestačí k vytvoření spojení a parametr window_handle roven NULL (nil);
uživatelské jméno nebo heslo jsou špatně;
v dialogu uživatel stiskl tlačítko Storno;
v ODBC driveru došlo k chybě.

Příklad

xcdp = ODBC_connect("Microsoft Access database", "david", "abc123", NULL);

Viz

ODBC_disconnect