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.