Bluetooth Special Interest Group Inc. BTSIG15A Manual De Usuario

The first step in using the PTS Control API is to open or create a Workspace. An open workspace is needed for all of the 
Project and Test Case related functions in the API. 

Declaration: 

HRESULT CreateWorkspace(ULONGLONG ullBthAddr, LPCWSTR pszPathOfPtsFile, LPCWSTR 
pszWorkspaceName, LPCWSTR pszWorkspacePath); 

  

  

Parameters: 

ullBthAddr: A 64 bit unsigned integer that contains the Bluetooth Device Address (BDADDR) of the 
Implementation Under Test (IUT). 

  

  

  

Note that a 64 bit value is used even though a BDADDR is only 48 bits in length. The BDADDR is located in 
the least significant 48 bits (six bytes) and the upper two bytes must have a value of 0x0000. 

  

  

  

pszPathOfPtsFile: A Unicode character string that contains the path to a ICS file describing the features of 
the IUT that was previously exported from the Test Plan Generator (TPG)/Qualified Listing Interface (QLI). 

  

  

  

The use of a full file path is recommended since the name is processed by the running instance of PTS. The 
instance of PTS may have a different current working directory than the Client Application. 

  

  

  

pszWorkspaceName: A Unicode character string containing the name of the Workspace to be created. This 
is just the name of the Workspace, not a file path to the intended Workspace location. 

  

  

  

pszWorkspacePath: A Unicode character string containing the path to the folder where the new Workspace 
should be created. The new Workspace will be created in a subfolder of this location, with the name of the 
subfolder coming from the pszWorkspaceName parameter 

  

  

  

The folder path must exist before making this call, PTS will not create any folders that are missing from the 
path specification. 

  

  

  

The use of a full path to the folder is recommended since it is processed by the running instance of PTS. 
The instance of PTS may have a different current working directory than the Client Application. 

  

  

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 section 
7 (“API Error Codes”).