API Guide
2-414 API Functions 601355 Rev A
VS_Table_
CreateAdd-
Entry
VS_Table_CreateAddEntry adds an entry to the
specified table at the first available location.
When a client adds an entry to a table using
VS_Table_CreateAddEntry, the VolServ API allocates
space for a table entry, copies the client’s data to the allocated
space, and adds an entry to the specified table for the copied
data. After calling VS_Table_CreateAddEntry, a client is
not required to maintain the information that has been stored in
the table.
Synopsis
VST_BOOLEAN VS_Table_CreateAddEntry
(VST_TABLE_HANDLE handle,
void * entry,
int size)
Arguments • handle = Handle of the table where the specified entry is
added.
• entry = Pointer to the entry to be copied and added to the
specified table.
• size = The size, in bytes, of the entry to be copied and
added to the specified table.
Return Values
VS_Table_CreateAddEntry returns:
• VSE_TRUE - Successful execution.
• VSE_FALSE - API failure - An appropriate error code is set
in VSG_Error.
• VSE_ERR_BADENTRY - Pointer to the entry to be stored
was null.
