Vidíte historickú verziu tejto stránky. Pozrite si aktuálnu verziu.

Porovnať s aktuálnou verziou Zobraziť históriu stránky

Verzia 1 Ďalej »

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ľa.

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

Deklarácia
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)

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.
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ľa.
Na prihláseného užívateľa sú aplikované všetky obmedzenia týkajúce sa prístupových práv.
pass Heslo užívateľa.
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ľ).
4 Interná chyba.


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

Deklarácia
Declare Sub VBApiLogOff Lib "vbapi.dll" Alias "_LogOff@0" ()

Poznámka
Skutočné ukončenie spojenia prebehne až pri odstránení knižnice z pamäti (unload dll) po ukončení programu MS Excel.

Súvisiace stránky:

D2000 VBApi

  • Žiadne štítky