Wavecom W51PC User Manual - page 11
User Manual W51PC DCOM Interface V1.1
Class W51Server
•
7
Retrieves the system status of the card. All the parameters are of type
BOOL and a TRUE or FALSE value is returned for each.
HRESULT SetUpdateRate([in] long lUpdateRate);
The rate at which call-back functions are called can be changed using
this function. The lUpdateRate parameter indicates the delay between
calls in milliseconds. The lUpdateRate parameter must have a value in
the range 100 to 5000 milliseconds.
HRESULT GetTextData([out] BSTR *Data);
Retrieves the text data from the card. A buffer will store the text data re-
ceived from the card and provide it when either the GetTextData function
or the NewTextData call back function occurs.
For codes that have more than one channel, e.g. PICCOLO or ARQ-M2-
242, special characters are inserted into the text data to separate the
channels.
Example: A{text data chn a}B{text data chn b}C{text data chn c}D{text
data chn d}.
Codes with only one channel don’t use these special characters
HRESULT GetRawData([in] long cMax,[out] long *pcActual, [out,
size_is(cMax), length_is(*pcActual)] BYTE *Data);
Retrieves the raw data (as a bit stream) from the card. The cMax para-
meter indicates the maximum length of the buffer used to receive the da-
ta. The pcActual parameter indicates the actual length of the data re-
ceived. Data points to the data.
HRESULT EnableCallBackText([in] BOOL Enable);
If EnableCallBackText is called with the Enable parameter TRUE the call
back function NewTextData will be enabled. To disable the call back
function, call EnableCallBackText with FALSE.
HRESULT EnableCallBackRaw([in] BOOL Enable);
If EnableCallBackRaw is called with the Enable parameter TRUE the call
back function NewRawData will be enabled. To disable the call back
function, call EnableCallBackRaw with FALSE.
HRESULT EnableCallBackStatus([in] BOOL Enable);
If EnableCallBackStatus is called with the Enable parameter TRUE the
call back function NewSystemStatus will be enabled. To disable the call
back function, call EnableCallBackStatus with FALSE.
HRESULT RawDataAsText([in] BOOL Enable);
Developers who prefer to work with Unicode strings instead of binary da-
ta can call this function to convert all the binary data to hex strings. After
calling RawDataAsText(TRUE) every BYTE that would have been made
available on the GetRawData() function will be converted to a two cha-
racter hex string and become available on the GetTextData() function.