Description The WFS_INF_PIN_STATUS command returns several kinds of status information.
Input Param None.
Output Param LPWFSPINSTATUS lpStatus;
typedef struct _wfs_pin_status
{
WORD fwDevice;
WORD fwEncStat;
LPSTR lpszExtra;
} WFSPINSTATUS, * LPWFSPINSTATUS;
fwDevice
Specifies the state of the PIN pad device as one of the following flags:
Value Meaning
WFS_PIN_DEVONLINE The device is on-line.
WFS_PIN_DEVOFFLINE The device is off-line.
WFS_PIN_DEVPOWEROFF The device is powered off.
WFS_PIN_DEVBUSY The device is busy processing a request.
WFS_PIN_DEVNODEVICE There is no device connected.
WFS_PIN_DEVHWERROR The device is inoperable due to a hardware error.
WFS_PIN_DEVUSERERROR The device is inoperable due to interference by a user.
fwEncStat
Specifies the state of the Encryption Module as one of the following flags:
Value Meaning
WFS_PIN_ENCNOTREADY The encryption module is not ready.
WFS_PIN_ENCNOTINITIALIZED The encryption module is not initialized (no master key loaded).
WFS_PIN_ENCINITIALIZED The encryption module is initialized and master key (where required) and any other initial keys are loaded; ready to import other keys.
WFS_PIN_ENCREADY The encryption module is initialized and ready (at least one key is imported into the encryption module).
WFS_PIN_ENCBUSY The encryption module is busy (implies that the device is busy).
WFS_PIN_ENCUNDEFINED The encryption module state is undefined.
lpszExtra
Specifies a list of vendor-specific, or any other extended, information. The information is returned as a series of “key=value” strings so that it is easily extendable by service providers. Each string will be null-terminated, with the final string terminating with two null characters.
Error Codes There are no additional error codes generated by this command.
Comments Applications which require or expect specific information to be present in the lpszExtra parameter may not be device or vendor-independent.