GetServiceInfo Method

Retrieves information about the specified service.

Syntax

• C++

ANSI (Cross Platform)
int GetServiceInfo(const char* lpszAddress, const char* lpszClassId);

Unicode (Windows)
INT GetServiceInfo(LPCWSTR lpszAddress, LPCWSTR lpszClassId);

#define MID_BTINFO_GETSERVICEINFO 5

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

Remarks

This method retrieves information about the service specified by ClassId that is listening on the device specified by Address.

This method may be used to retrieve information about a specific service. This is useful in situations where you know the Address and ClassId of the service and do not wish to list all the services via ListServices.

After calling this method ServiceCount will be 1 and ServiceIndex will automatically be set to 0 to select the service. The following properties will be populated with information about the service:

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

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

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)