API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

IBTDISCOVERER_RETRIEVEREMOTENAME()

Brew Release
Brew MP 1.0.2
See Also
IBTDiscoverer_StartRemoteNameReq
Description
Retrieve the remote device's name in UTF-8 format. The name is obtained from the remote device when IBTDiscoverer_StartRemoteNameReq() is invoked.
Params
_me
[in]:
The object
bdAddr
[in]:
Address of remote device
name
[out]:
Pointer to buffer to hold the device name.
nameLen
[in]:
Length of the buffer.
nameLenReq
[out]:
Place holder for length of the buffer required to hold the entire name.
Return
AEE_SUCCESS
[]:
Name successfully returned. If nameLen is smaller than the length of buffer required to return the entire name, partial name will be returned. nameLenReq, will contain the buffer size required to hold the entire name, including the NUL terminator. The application should allocate the required buffer size and call this API again. The returned name will be NUL terminated.
AEE_ENOSUCH
[]:
No name available for the specified device
AEE_EBADSTATE
[]:
Driver error. Another appropriate error code if operation was not successful
Interface
Prototype
  •    AEEResult IBTDiscoverer_RetrieveRemoteName(IBTDiscoverer*   _me,
                                                  const BDAddress* bdAddr,
                                                  char*            name,
                                                  int              nameLen,
                                                  int*             nameLenReq)
    
Side Effect
  • None.
Comments
None.