Справочное Руководство для Intermec 5055

Скачать
Страница из 216
im_get_config_info
5-21
5
im_get_config_info
Purpose:
This function retrieves the current 5055 configuration information string and its length.
The command code is passed in as a string, and the current configuration is returned in
the same string. For a list of reader and configuration commands, see Chapter 6,
“Reader Command Reference,” and Chapter 7, “Configuration Command Reference.”
Syntax:
#include "im5055.h"
IM_STATUS im_get_config_info
    (IM_CHAR far *
config
,
    IM_USHORT far *
length
);
IN Parameters:
None.
IN/OUT
config    As input, this parameter is the desired computer command (two characters) and
Parameters:
should be NULL terminated. You can pass in several command codes at one time. As
output, this parameter contains the requested configuration information string. The first
two characters specify the configuration command returned. Any subsequent characters
specify the configuration options currently set.
For example, to get the beep duration setting, set config to “BD.” The function returns
BD and the current configuration for beep duration. The user of this function must
ensure that this character pointer points to a block of memory large enough to fit the
returned NULL terminated configuration information string.
OUT Parameters:
length    Length of the configuration information string.
Return Value:
This function returns one of these codes:
IM_SUCCESS    Successfully parsed and returned configuration info string.
IM_UNKNOWN_CONFIG    Unable to parse configuration request string.
Notes:
This function differs from im_command in that you only pass the two-character
command identifier. The im_command function passes an entire command string.
See Also:
im_command