D2000 VBApi - Práca s archivovanými hodnotami

Získanie archivovaných hodnôt určitého archívneho objektu zabezpečí volanie procedúry VBApiGetArchData (procedúra VBApiGetArchDataItem pre štruktúrované archívne objekty). Hodnoty získané z archívu sú reprezentované poľom hodnôt. Archívna hodnota je reprezentovaná rovnakou štruktúrou ako okamžitá hodnota.

Deklarácia
Declare Sub VBApiGetArchData Lib "vbapi.dll" Alias "_GetArchData@28" (arr() As VBApi_TUniVal, ByRef name As String, ByRef bt As Date, ByRef et As Date, ByRef step As Long, ByRef writeMethod As Long, ByRef ok As Long)

 
alebo pre štruktúrované objekty typu Archivovaná hodnota
 
Declare Sub VBApiGetArchDataItem Lib "vbapi.dll" Alias "_GetArchDataItem@36" (Arr() As VBApi_TUniVal, ByRef name As String, ByRef row As Long, ByRef col As Long, ByRef bt As Date, ByRef et As Date, ByRef step As Long, ByRef writeMethod As Long, ByRef ok As Long)

Parametre
arr Pole výsledných hodnôt získaných z archívu pri úspešnom volaní.

Upozornenie:
Je potrebné, aby pred volaním procedúry bolo pole arr nedimenzované a prázdne!
name Meno objektu typu Archivovaná hodnota.
bt Počiatočný čas.
et Koncový čas.
step Časový krok, s ktorým budú prevzorkované hodnoty v archíve v sekundách. Ak je 0, budú načítané všetky hodnoty v danom časovom intervale.
row Riadok štruktúrovaného objektu typu Archivovaná hodnota.
col Stĺpec štruktúrovaného objektu typu Archivovaná hodnota.
writeMethod Vráti spôsob archivácie hodnoty.
Návratové hodnoty:
  • 1 - periodicky
  • 2 - pri zmene hodnoty (Filter)
ok Návratová hodnota - úspešnosť volania.

Návratová hodnota
Hodnota parametra ok.

Návratová hodnota Popis
0 Úspešné volanie.
1 Zlé meno objektu (aj v prípade, že objekt nebol otvorený).
2 Neprihlásený užívateľ.
3 Neočakávaná interná chyba.
4 Zlé parametre.


Zmenu jednej hodnoty v archíve je možné vykonať volaním procedúry VBApiChangeArchValue (procedúra VBApiChangeArchValueItem pre štruktúrované archívne objekty). Nová hodnota je daná parametrom newValue. Čas pre, ktorý je archivovaná hodnota menená, je daný hodnotou položky ValTime v štruktúre VBApi_TUniVal.

Deklarácia
Declare Sub VBApiChangeArchValue Lib "vbapi.dll" Alias "_ChangeArchValue@16" (ByRef name As String, ByRef newValue As VBApi_TUniVal, ByRef ok As Long)

 
alebo pre štruktúrované objekty typu Archivovaná hodnota
 
Declare Sub VBApiChangeArchValueItem Lib "vbapi.dll" Alias "_ChangeArchValueItem@20" (ByRef name As String, ByRef row As Long, ByRef col As Long, ByRef newValue As VBApi_TUniVal, ByRef ok As Long)

Parametre
name Meno objektu typu Archivovaná hodnota.
newValue Nová hodnota s časom, pre ktorý sa zaarchivuje.
row Riadok štruktúrovaného objektu typu Archivovaná hodnota.
col Stĺpec štruktúrovaného objektu typu Archivovaná hodnota.
ok Návratová hodnota - úspešnosť volania.

Návratová hodnota
Hodnota parametra ok.

Návratová hodnota Popis
0 Úspešné volanie.
1 Zlé meno objektu (aj v prípade, že objekt nebol otvorený).
2 Neprihlásený užívateľ.
3 Neočakávaná interná chyba.
4 Zlé parametre.

Poznámka
V prípade, že pre daný čas v archíve nie je zaarchivovaná hodnota (nie je čo meniť), bude hodnota newValue do archívu vložená.

Súvisiace stránky:

D2000 VBApi

Napíšte komentár