|
|
NameServer_Handle type. More...
#include <NameServer.h>
Data Fields | |
| UInt | maxRuntimeEntries |
| Maximum name/value pairs that can be dynamically created. More... | |
| Ptr | tableHeap |
| Name/value table is allocated from this heap. More... | |
| Bool | checkExisting |
| Check if a name already exists in the name/value table. More... | |
| UInt | maxValueLen |
| Length, in MAUs, of the value field in the table. More... | |
| UInt | maxNameLen |
| Length, in MAUs, of the name field in the table. More... | |
NameServer_Handle type.
| UInt NameServer_Params::maxRuntimeEntries |
Maximum name/value pairs that can be dynamically created.
This parameter allows NameServer to pre-allocate memory. When NameServer_add() or NameServer_addUInt32() is called, no memory allocation occurs.
If the number of pairs is not known at configuration time, set this value to NameServer_ALLOWGROWTH. This instructs NameServer to grow the table as needed. NameServer will allocate memory from the NameServer_Params.tableHeap when a name/value pair is added.
The default is NameServer_ALLOWGROWTH.
| Ptr NameServer_Params::tableHeap |
Name/value table is allocated from this heap.
The instance table and related buffers are allocated out of this heap during the dynamic create. This heap is also used to allocate new name/value pairs when NameServer_ALLOWGROWTH for NameServer_Params.maxRuntimeEntries
The default is to use the same heap that instances are allocated from which can be configured via the NameServer.common$.instanceHeap configuration parameter.
| Bool NameServer_Params::checkExisting |
Check if a name already exists in the name/value table.
When a name/value pair is added during runtime, if this boolean is true, the table is searched to see if the name already exists. If it does, the name is not added and the NameServer_E_ALREADYEXISTS error is returned.
If this flag is false, the table will not be checked to see if the name already exists. It will simply be added. This mode has better performance at the expense of potentially having non-unique names in the table.
This flag is used for runtime adds only. Adding non-unique names during configuration results in a build error.
| UInt NameServer_Params::maxValueLen |
Length, in MAUs, of the value field in the table.
Any value less than sizeof(UInt32) will be rounded up to sizeof(UInt32)
| UInt NameServer_Params::maxNameLen |
Length, in MAUs, of the name field in the table.
The maximum length of the name portion of the name/value pair. The length includes the null terminator ('\0').
