Bluetooth Special Interest Group Inc. BTSIG15A Manual Do Utilizador

Página de 162
Printed Documentation 
80 
Return 
values: 
Return values: A value greater than or equal to zero if successful. 
A value less than zero if not successful. For a list of error codes specific to the PTS Control API see 
API 
Error Codes
  
This function updates the value of a IXIT item for the selected Project. IXIT items have data types associated with them. 
This means that the pszNewParamValue string must only contain characters that are appropriate for the associated data 
type. 
  
Data Type 
Legal Characters For The New Value 
BITSTRING 
0, 1 
BOOLEAN 
The words TRUE or FALSE (case sensitive) 
IA5STRING 
No restrictions 
INTEGER 
Decimal digits 0 to 9 
OCTETSTRING 
Hexadecimal “digits” 0 to 9 and A to F (“A” to “F” must be 
upper case) 
  
  
  
  
  
  
  
  
Logging and unattended operation 
During normal operation PTS sends informational output to the Test Case execution log in the upper right hand corner of 
the PTS User Interface. Client Application programs may take over this functionality and divert the log output to a function 
within the application. 
Additionally, at various points during the execution of a Test Case, PTS will display dialog boxes prompting the test 
operator to take an action. There are two ways to remove the test operator and replace them with user written code: 
1. 
Develop a custom Implicit Send DLL as described in the “Automating – Using Implicit Send” reference 
document. 
2. 
Use the functions provided in the PTS Control API to divert the operator prompts to the Client Application. 
Logging 
There are two steps necessary to divert the test case execution log to a Client Application application. The first is to create 
a COM based object derived from IPTSControlClientLogger. The object needs to implement the following functions that 
are needed by the Component Object Model: 
 
AddRef()