ListServices Method

List local or remote services.

Syntax

• C++

ANSI (Cross Platform)
char* ListServices(const char* lpszAddress);

Unicode (Windows)
LPWSTR ListServices(LPCWSTR lpszAddress);

#define MID_BTINFO_LISTSERVICES 7

IPWORKSBT_EXTERNAL int IPWORKSBT_CALL IPWorksBT_BTInfo_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method lists services on the device specified by Address.

This may be used to list services on the local device or a remote device. After calling this method the ServiceCount property will reflect the number of services that were found. To find details for each service set ServiceIndex to select a service. Valid values for ServiceIndex are from 0 to ServiceCount -1.

After setting ServiceIndex the following properties will be populated with information about the service:

• ServiceAddress
• ServiceClassId
• ServiceComment
• ServiceName
• ServiceOtherClassId
• ServicePort
• ServiceProtocol

Information about the services may also be retrieved from the ServiceInfo event, which will fire once for each service.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.