SVR5 and SCO OpenServer 5

GetStatus(D3pccard)

GetStatus -- return status of client's socket and card

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (GetStatus, int n1,
                     int n2, int StatusLen,
                     Status_t *pStatus, rm_key_t key);

Description

GetStatus( ) returns the current status of a client's card's socket and the status of the card itself if inserted. The return value from the service includes information about the logical socket, the card state and the socket state.

Arguments

n1: NULL
n2: NULL
StatusLen: Length of the Status(D4pccard) structure.
pStatus: Pointer to a Status(D4pccard) structure.
key: Resource manager key.

Return values

BAD_ARG_LENGTH: StatusLen is not equal to 6.
BAD_SOCKET: Socket not valid.
NO_CARD: Card not inserted.
SUCCESS: Valid socket with card inserted.

Usage

The card function is passed in the C struct Status_t : usSocket. usSocket is two bytes long. The more significant byte indicates the function. The function of single function cards is mapped to zero. The functions of multi-function cards are enumerated from zero on up to the number of functions available less one. The low byte in usSocket indicates logical socket.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

Status(D4pccard)