HC_PShow_One_Net_User_Data
-
long
HC_PShow_One_Net_User_Data(int count, Key const keys[], intptr_t index, void *data, long data_length) - long HC_PShow_One_Net_User_Data(int count, Key const keys, intptr_t index, void data, long data_length)
Similar to Show_One_User_Data() but returns the net effective settings along a discrete segment path.
Parameters
count: The size of keys
keys: An array of HC_KEY’s delineating a path of segments.
index: A unique indentifier associated with the user data.
data: A pointer to a buffer which can be populated with binary data associated with the index.
data_length: The size of the data buffere beings passed.
Returns
- 0 if no matching index was found.
- A negative number if the data found was too large for the buffer. The absolute value is the actual size of the user data.
- A positive number if the data found and written into the passed data buffer. The return value indicates the size of the data.