Magtek EXPRESSCARD 1000, Programming Reference Manual

Page: 27 / 33

Section 3 – API DLL
Example
char Settings [4096];
DWORD SettingsBufferSize;
// Initialize Settings
// Initialize the Settings variable first
SettingsBufferSize =4096;
// Set a value of “4” to the key “Number” in section “ImageOptions”and store this new key/value pair in the buffer” Settings”
dwStatus=MTECSDK_SetValue(Settings, "ImageOptions","Number","4", &SettingsBufferSize);
MTECSDK_GetValue
MTECSDK_GetValue function retrieves a key/value pair that was previously stored in the pcDocInfo parameter using
MTECSDK_SetValue function
ULONG MTECSDK_GetValue (
char
*pcDocInfo,
char *pcSection,
char *pcKey,
char *pcValue,
DWORD *pdwLength
);
Parameters
pcDocInfo
Buffer pointer containing all the key/value pairs.
pcSection
Pointer to null terminated string containing the section name.
pcKey
Pointer to null terminated string containing the key name.
pcValue
Pointer to the buffer that receives the retrieved string.
pdwLength
Specifies the size of the pcValue buffer.
Return Values
EC_ST_OK
EC_ST_NOT_ENOUGH_MEMORY
EC_ST_ERR_LOAD_XML
EC_ST_ERR_GET_DOM_POINTER
EC_ST_BAD_DATA
EC_ST_BAD_SECTION_NAME
EC_ST_BAD_KEY_NAME
EC_ST_BAD_VALUE_BUFFER
EC_ST_BAD_BUFFER_LENGTH
EC_ST_KEY_NOT_FOUND
21