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 použí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


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 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)

nameMeno používateľa.
Na prihláseného používateľa sú aplikované všetky obmedzenia týkajúce sa prístupových práv.
passHeslo používateľa.
connStrParameter typu string. Umožňuje zadať ďalšie štartovacie parametre, ktoré modifikujú správanie procesu.
wdFreqInterval 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.
okNávratová hodnota - priebeh prihlásenia.
Návratová hodnota

Hodnota parametra ok.

Návratová hodnotaPopis
0Prihlásenie prebehlo úspešne.
1Opakované pripojenie nie je možné.
2Nebeží proces D2000 Server.
3Zlé meno alebo heslo (pripojenie k procesu D2000 Server prebehlo, ale ešte nie je prihlásený používateľ).
4Interná 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

Napíšte komentár