Bluetooth Special Interest Group Inc. BTSIG15A Manual De Usuario

Descargar
Página de 162
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. 
  
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. 
  
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”. 
  
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. 
  
 
  
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.