Bluetooth Special Interest Group Inc. BTSIG15A Manual De Usuario
Automating
63
strMmiText describes the information that is being requested.
The return value from ImplicitSendStyle() should be a pointer to a character string containing the requested data, if the
data is available. If the requested data is not available, or an error occurs, a NULL pointer should be returned.
data is available. If the requested data is not available, or an error occurs, a NULL pointer should be returned.
As has been noted above, the string pointed at by the return value should not be allowed to go out of scope. (
Implicit
Send functions
.)
“Select item from a list” message type
For this message strMmiText contains a list of strings separated by newline characters. (C/C++: ‘\n’, ASCII code 0x0A.)
The first string in the list contains the instructions to the user. The rest of the strings provide a list values for selection. The
list is ended by an empty line.
The first string in the list contains the instructions to the user. The rest of the strings provide a list values for selection. The
list is ended by an empty line.
For example, strMmiText may contain the following information
“{<message tag>}Please select a device.\nmyPhone\nmyLaptop\nmyPda\n\n”
The first item in the list (“Please select a device.”) indicates that a list of devices follows and that one of the devices should
be selected. There are three devices in the list: ”myPhone”, “myLaptop”, and ”myPda”.
be selected. There are three devices in the list: ”myPhone”, “myLaptop”, and ”myPda”.
The items in the list are separated by newline characters, indicated as ’\n’ above. The extra ’\n’ at the end of the string
marks the end of the list.
marks the end of the list.
The expected return value is a pointer to a string containing one of the values from the list. A NULL pointer should be
returned in case of error or if none of the values are appropriate at that point in the test.
returned in case of error or if none of the values are appropriate at that point in the test.