Funkce naváže spojení klienta s databázovým serverem server_name. Tento server musí být na počítači klienta registrován.
Alternativně lze pro spojení na server pomocí protokolu TCP/IP použít parametr server_name ve tvaru IP_adresa:port, například "192.168.3.55:6001". Tento tvar je výhodný pro servery, které nejsou lokálně registrovány.
Funkce cd_connect se musí volat jako součást obálky aplikace vytvořené v jazyce C/C++ nebo Pascal/Delphi předtím, než zašlete serveru první požadavek. Funkce nahrazuje zastaralé funkce link_kernel a interf_init. Vytvořené spojení musí klient před ukončením práce uzavřít voláním procedury disconnect.
Parametr show_type se uplatní pouze tehdy, pokud se v důsledku provedení této funkce spouští lokální server. Spuštěný server předá tento parametr svému hlavnímu oknu při prvním volání Windows API funkce ShowWindow. Doporučujeme použít hodnotu SW_MINIMIZE definovanou v hlavičkovém souboru windows.h . Je-li parametr show_type roven -1, funkce nespustí lokální server (server musí předem běžet).
Funkce vrací některou z konstant KSE_.... Konstanta KSE_OK má nulovou hodnotu a znamená provedení funkce bez chyby. Ostatní konstanty označují různé druhy chyb.
cdp_init(&cd);
if (cd_connect(&cd, "MY_SERVER", SW_MINIMIZE) == KSE_OK)
{ if (!cd_Login(&cd, username, password))
if (!cd_Set_application(&cd, schemana_name))
................................................
cd_disconnect(&cd);
}