HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001
ObjectId:
is a 64 bit unique number to refer to the Object.
pCallerTransAborted:
indicates whether the caller’s TMF transaction has been aborted
0 = not aborted
1 = aborted
3.2.7 GetSystemErrorString
This returns the most recent error string associated with a system error. The calling
application might call this function to retrieve more information about why the API
returned 100 (system error) in the previous call.
short GetSystemErrorString (const char *pBuffer // output
, short *pBufferLength //
input/output
);
Return Value:
0 = Successful
pBuffer:
a pointer to the address of the buffer containing the error string.
BufferLength:
On input, the length of the error string buffer is allocated by the caller. On
output, the length of the string is actually used by the function.
3.3 Management APIs
Unlike the Core APIs, calling applications do not need to open the buddy group
before calling Management APIs.
3.3.1 CreateBuddyGroup
Creates a new BuddyGroup. This new BuddyGroup is created with a status of
“inactive”. The BuddyGroup only becomes active once the first BuddySet is created
for that BuddyGroup as until then, the BuddyGroup contains no storage.
The API uses parameters from the default BuddyGroup, however, any values which
need to be changed for this BuddyGroup can be set separately using the function
SetBuddyGroupParm.
short CreateBuddyGroup (const char *pBuddyGroupName //
input
, short *pCallerTransAborted //
output
);
Return value:
0 = Successful
111 = Failed - Buddy Group already exists
140 = Failed – Default parameters not found
100 = System error (call GetSystemErrorString)
Page 14 of 37