D2000 VBApi - Nadviazanie a ukončenie spojenia so systémom D2000

Pred volaním procedúr, ktoré komunikujú s jadrom systému procesom (D2000 Server), je potrebné sa na neho pripojiť. Pripojenie zahŕňa dve činnosti:

vybudovanie komunikačnej cesty,
prihlásenie užívateľapoužívateľa.

Uvedené činnosti zabezpečuje procedúra VBApiLogOn alebo VBApiLogOnEx.

Procedúra VBApiLogOnEx umožňuje zadať ďalšie štartovacie parametre, ktoré modifikujú správanie procesu.

Deklarácia

Blok kódu

language	esl
theme	Confluence

Declare Sub VBApiLogOn Lib "vbapi.dll" Alias "_LogOn@24" (ByRef server As String, ByRef procDesc As String, ByRef name As String, ByRef pass As String, ByRef wdFreq As Long, ByRef ok As Long)


alebo


Declare Sub VBApiLogOnEx Lib "vbapi.dll" Alias "_LogOnEx@24" (ByRef server As String, ByRef procDesc As String, ByRef name As String, ByRef pass As String, ByRef connStr As String, ByRef ok As Long)

Parametre

server	Za účelom vybudovania komunikačnej cesty je potrebné poznať meno počítača, kde sa nachádza bežiaci proces D2000 Server. Tento parameter má rovnaký význam, ako parameter /S na príkazovom riadku pri spúšťaní bežného klient procesu systému. Pre funkciu VBALogOnEx: V prípade pripájania do redundantnej skupiny je potrebné zadať tento parameter ako prázdny string. Pripojenie prebehne tak, že prostredníctvom parametera parametra connStr použijeme štartovací parameter /RF alebo /RD.
procDesc	V nižších verziách (ako 4.10) parameter špecifikoval meno klient procesu, pod ktorým sa rozhranie prihlási k systému, za ktoré sa automaticky pridala prípona .API. Parameter nahrádzal parameter /W z príkazového riadku. Vo verzii 4.10 (a vyššie) má parameter len informatívny význam. Hodnota parametra sa zapisuje do monitorovacej databázy systému pri štarte procesu (vhodné pre identifikáciu rozhrania pre ladiace účely). Meno procesu, pod ktorým sa rozhranie prihlási, je automaticky generované a má nasledujúcu štruktúru: WsName_XX.VBA. kde: WsName - meno počítača v sieti. Znaky v mene počítača, ktoré nevyhovujú mennej konvencii objektov pre D2000 sú nahradené znakom _. XX - hodnota od 00 do 99 .VBA - prípona procesu (v predchádzajúcich verziách bola .API)
name	Meno užívateľapoužívateľa. Na prihláseného užívateľa používateľa sú aplikované všetky obmedzenia týkajúce sa prístupových práv.
pass	Heslo užívateľapoužívateľa.
connStr	Parameter typu string. Umožňuje zadať ďalšie štartovacie parametre, ktoré modifikujú správanie procesu.
wdFreq	Interval medzi watch dog správami pre priebežné overovanie priechodnosti komunikačnej cesty. Parameter nahrádza parameter /F z príkazového riadku.
unival	Štruktúra predstavujúca okamžitú hodnotu objektu.
ok	Návratová hodnota - priebeh prihlásenia.

Návratová hodnota

Hodnota parametra ok.

Návratová hodnota	Popis
0	Prihlásenie prebehlo úspešne.
1	Opakované pripojenie nie je možné.
2	Nebeží proces D2000 Server.
3	Zlé meno alebo heslo (pripojenie k procesu D2000 Server prebehlo, ale ešte nie je prihlásený

užívateľ

používateľ).
4	Interná chyba.

Procedúra VBApiLogOff slúži na formálne ukončenie spojenia s jadrom systému D2000.

Info

title	Súvisiace stránky:

D2000 VBApi

Strom stránky

Porovnávané verzie

Stará verzia 3

Nová verzia Aktuálny

Kľúč

D2000 VBApi - Nadviazanie a ukončenie spojenia so systémom D2000

Strom stránky

História stránky

Porovnávané verzie

Stará verzia 3

Nová verzia Aktuálny

Kľúč

D2000 VBApi - Nadviazanie a ukončenie spojenia so systémom D2000