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 drukarki. | |
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_GetPrnDeviceStatus (POSNET_HANDLE hLocalDevice, const char statusMode, long *globalStatus, long *printerStatus) |
Pobranie statusu drukarki. Drukarka jest periodycznie odpytywana o status i rezultat tej operacji jest przechowywany. Funkcja jest blokująca jeśli wykonywane jest odpytywanie. | |
POSNET_API POSNET_STATUS __stdcall | POS_GetRequestStatus (POSNET_HANDLE hRequest) |
Zwróć status rozkazu. |
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.
hLocalDevice | Uchwyt lokalny urządzenia lub uchwyt globalny urządzenia. |
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:\
code | Kod błędu do wyjaśnienia | |
lang | 2 znakowy kod języka wg ISO-3166 |
POSNET_API POSNET_STATUS __stdcall POS_GetPrnDeviceStatus | ( | POSNET_HANDLE | hLocalDevice, | |
const char | statusMode, | |||
long * | globalStatus, | |||
long * | printerStatus | |||
) |
Pobranie statusu drukarki. Drukarka jest periodycznie odpytywana o status i rezultat tej operacji jest przechowywany. Funkcja jest blokująca jeśli wykonywane jest odpytywanie.
hLocalDevice | Lokalny uchwyt urządzenia | |
statusMode | Sposób uzyskania statusu - 0 - zwróć ostatni status automatyczny , 1 - odpytaj urządzenie jeśli brak statusu - blokujące! | |
globalStatus | Status urządzenia zwracany przez rozkaz sdev (-1 jeśli nie odpytano) | |
printerStatus | Status mechanizmu drukującego (nieistotny jeśli sdev=-1) |
POSNET_API POSNET_STATUS __stdcall POS_GetRequestStatus | ( | POSNET_HANDLE | hRequest | ) |
Zwróć status rozkazu.
UWAGA: W celu efektywnego zarządzania błędami (w sytuacji, gdy drukarka zwraca błędy w róznych postaciach) zarządzanie błędami zostało zunifikowane - nazwa rozkazu zostaje umieszczona w polu "cm" odpowiedzi, kod błędu natomiast umieszczany jest także w polu o nazwie "!error" odpowiedzi. Dzięki temu postać odpowiedzi jest identyczna w przypadku błędów ramki i błędów.
hRequest | Uchwyt rozkazu (żądania wychodzącego lub odpowiedzi z drukarki) |