Diff: ble/Gap.h

Revision:

1101:c3d484a482d8

Parent:

1100:6c54ccecf1e8

Child:

1105:0244fbb0324e

diff -r 6c54ccecf1e8 -r c3d484a482d8 ble/Gap.h
--- a/ble/Gap.h	Mon Jan 11 08:51:54 2016 +0000
+++ b/ble/Gap.h	Mon Jan 11 08:51:54 2016 +0000
@@ -620,7 +620,8 @@
 
     /**
      * Update a particular ADV field in the advertising payload (based on
-     * matching type).
+     * matching type and length). Note: the length of the new data must be the
+     * same as the old one.
      *
      * @param[in] type  The ADV type field describing the variable length data.
      * @param[in] data  Data bytes.
@@ -629,7 +630,7 @@
      * @note: If advertisements are enabled, then the update will take effect immediately.
      *
      * @return BLE_ERROR_NONE if the advertisement payload was updated based on
-     *         matching AD type; otherwise, an appropriate error.
+     *         a <type, len> match; otherwise, an appropriate error.
      */
     ble_error_t updateAdvertisingPayload(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len) {
         if (type == GapAdvertisingData::COMPLETE_LOCAL_NAME) {