Obsługa błędów


Moduły

 Kody błędów biblioteki
 Kody błędów biblioteki. Biblioteka może zwracać kody błędów zarówno własne jak i kody bezpośrednio uzyskane z kasy.

Funkcje

POSNET_API POSNET_STATUS __stdcall POS_GetError (POSNET_HANDLE hLocalDevice)
 Podaj kod statusu związany z uchwytem urządzenia.
POSNET_API const char *__stdcall POS_GetErrorString (POSNET_STATUS code, char *lang)
 Zwróć tekstowy opis błędu.
POSNET_API POSNET_STATUS __stdcall POS_GetRequestStatus (POSNET_HANDLE hRequest)
 Zwróć status rozkazu.

Dokumentacja funkcji

POSNET_API POSNET_STATUS __stdcall POS_GetError ( POSNET_HANDLE  hLocalDevice  ) 

Podaj kod statusu związany z uchwytem urządzenia.

Zwraca ostatnio ustawiony kod statusu związany z uchwytem urządzenia. Każda wywoływana funkcja oprócz zwrócenia tej wartości jako wyniku działania (o ile nie zwraca innego rodzaju rezultatu) ustawia wewnętrzny znacznik błędu.

Parametry:
hLocalDevice Uchwyt lokalny urządzenia lub uchwyt globalny urządzenia.
Zwraca:
Kod statusu patrz Kody błędów biblioteki Kody błędów.

POSNET_API const char* __stdcall POS_GetErrorString ( POSNET_STATUS  code,
char *  lang 
)

Zwróć tekstowy opis błędu.

Funkcja zwraca tekstowy opis błędu zrozumiały dla użytkownika / programisty. Komunikat może być zwrócony we wskazanym języku (o ile przygotowano niezbędny plik językowy). W przeciwnym wypadku komunikat zwracany jest w domyślnym języku biblioteki.

UWAGA: W systemie Linux pliki z tekstowymi opisami kodów błędów (pliki językowe o nazwach w postaci posnet_xx.lng mogą być umieszczone w katalogu, z którego uruchomiono program (nie zalecane) lub w miejscu wskazywanym przez zmienną środowiskową POSNET_LIB_SHARE_DIR (zalecane). W systemie WINDOWS katalog wskazany w POSNET_LIB_SHARE_DIR musi być zakończony znakiem „\” rozdzielającym katalogi np. POSNET_LIB_SHARE_DIR=c:\

Parametry:
code Kod błędu do wyjaśnienia
lang 2 znakowy kod języka wg ISO-3166
Zwraca:
Ciąg znaków opisujących zdarzenia (C-string) zakoczńony znakiem 0. Ciąg ten zwracany jest z wewnętrznego bufora. Nie wolno go zwalniać funkcjami allokacji pamięci.

POSNET_API POSNET_STATUS __stdcall POS_GetRequestStatus ( POSNET_HANDLE  hRequest  ) 

Zwróć status rozkazu.

Zwraca:
Funkcja zwraca kod błędu związany z rozkazem. W przypadku odebrania odpowiedzi o błędzie wykonania rozkazu zwracane są kody odebrane od kasy, są one także dostępne w polach rezultatu komendy w postaci zgodnej z Instrukcją Programisty. Kody o wartościach 0x00000000-0x0042FFFF służą do przekazywania stanu rozkazu w ramach biblioteki. Kody o wartościach 0x00430000-0x0043FFFF wykorzystywane są w przypadku negatywnej odpowiedzi kasy na rozkaz, po jego zakończeniu w wyniku błędu kasy – kod błędu kasy zwiększony jest o wartość 0x00430000. Kody o wartościach 0x00440000-0x0044FFFF wykorzystywane są w przypadku negatywnej odpowiedzi kasy na rozkaz, po jego zakończeniu w wyniku błędu transmisji – kod błędu transmisji zwiększony jest o wartość 0x00440000.
Zobacz rĂłwnieĹĽ:
Obsługa synchroniczna kasy "Obsługa synchroniczna kasy"


Wygenerowano Wed Apr 15 20:03:07 2009 dla POSNET COMBO LIBRARY programem  doxygen 1.5.8