MagTek EC2000 99875713 - Manual (Page 15)

2 - Functions
ExpressCard 2000| Instant Issuance Card Personalization System | Programmer’s Reference (Windows SDK)
Page 15 of 21
If the pcOptions buffer is not large enough to add the new attribute, the function returns
EC_ST_NOT_ENOUGH_MEMORY, and returns the required size of the buffer in pdwLength.
If pdwLength is less than the size of pcOptions after the new attribute is added, the function returns
EC_ST_NOT_ENOUGH_MEMORY.
Example: None
2.7 MTECSDK_ProcessDoc
This function sends a card personalization transaction with the specified options to the device with the
specified name. When the device completes the transaction, the result is returned in pcDocInfo.
ULONG MTECSDK_ProcessDoc (
char *pcDevName,
char *pcProcessOptions,
char *pcDocInfo,
DWORD *pdwDocInfoSize
);
For every card personalization transaction, the EC2000 requires a new set of options detailing how the
card will be personalized (image files, text lines, magnetic stripe data, embosser data, and so on). The
options are stored as key-value pairs in the buffer pointed to by pcProcessOptions.
Parameters:
pcDevName - Pointer to a null-terminated string containing device name.
pcProcessOptions - Pointer to a buffer containing the options to be used in processing the card. The
options are stored in the buffer by using function MTECSDK_SetValue.
pcDocInfo - Pointer to the buffer containing the information returned from the device. The returned
information contains Command status, MagnePrint data, Magstripe data, Smartcard data, and Device
status information.
pdwDocInfoSize - Size of the buffer pcDocInfo.
Return Values:
EC_ST_OK
EC_ST_NOT_ENOUGH_MEMORY
EC_ST_PROCESS_CARD_FAILED
EC_ST_BAD_DATA
EC_ST_BAD_BUFFER
EC_ST_BAD_BUFFER_LENGTH
EC_ST_BAD_DEVICE_NAME
EC_ST_DEVICE_NOT_OPEN
EC_ST_DEVICE_NOT_RESPONDING
EC_ST_REQUEST_TIMEDOUT
EC_ST_CONNECT_REQUEST_TIMEDOUT
EC_ST_ERR_INTERNET_CONNECT
EC_ST_ERR_HTTP_OPEN_REQUEST
EC_ST_ERR_HTTP_SEND_REQUEST
Remarks:
If the function succeeds, the return value is EC_ST_OK.