BLE_GAP_GetAdvAddr

C

uint16_t BLE_GAP_GetAdvAddr(uint8_t advHandle, BLE_GAP_Addr_T *p_addr);

Description

Retrieves the advertising address used in advertising events for a given advertising handle.

Parameters

ParameterDescription
[in] advHandleThe advertising handle. Use value 0xF0 to retrieve the address of legacy advertising.
[in] p_addrPointer to a BLE_GAP_Addr_T structure to store the advertiser's Bluetooth address and address type.

Return values

Return valueDescription
MBA_RES_SUCCESSSuccessfully retrieves the advertisier advertising address.
MBA_RES_FAILAnonymous advertisement; no address available.
MBA_RES_OOMInternal memory allocation failure occurred.
MBA_RES_COMMAND_DISALLOWEDCommand disallowed due to a conflicting operation or state.
MBA_RES_UNKNOWN_ADV_IDUnknown advertising identifier.