Philips Bluetooth QuickStart Kit User Manual

Page 64

Bluetooth QuickStart Kit Version 1.0 - User’s Guide

Page 64

REG_RESULT_VAL_TRUNC – There was not enough space in the output buffer for
the complete value. It has been truncated.

B.7.4 regRemove

tRegResult regRemove( tU8* pKey, tU8 keyLen )

Remove a symbol from the registry. Both key and value will be removed.

Parameters:

[in] pKey – the registry key to be removed
[in] keyLen – the length of the key in bytes.

Returns:

REG_RESULT_OK if the key was successfully removed.

Possible error situations (what can be identified in an error code):

REG_RESULT_OK

- The function completed successfully.

REG_RESULT_NO_KEY – The key did not exist in the registry.

B.7.5 regNextKey

tRegResult regNextKey( tU8* pKey, tU8 keyLen, tU8* pLen, tS32*

pState )

This function is used to iterate over all available keys in the registry. The first time this
function is called *pState must be equal to REG_ITERATOR_START.
Parameters:

[in] pKey – the key is copied to this buffer
[in] keyLen – the length of the key buffer in bytes.
[in] pLen – number of bytes copied to the key buffer.
[in/out] pState – keeps state information. When the first key should be found this
parameter must be set to REG_ITERATOR_START.

Returns:

REG_RESULT_OK if the key was successfully found.

Possible error situations (what can be identified in an error code):

REG_RESULT_OK

- The function completed successfully.

REG_RESULT_NO_KEY – When no more keys are found.