HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001
112 = Failed - Buddy Group not found
113 = Failed - Buddy Group Inactive
115 = Failed - Buddy Group already open
117 = Failed – Another Buddy Group is already open
100 = a system error occurred (call GetSystemErrorString)
pBuddyGroupName:
is a 5 character alphanumeric name with no embedded spaces for example, “GRP01”
or “B01”
3.2.2 CloseBuddyGroup
Close all Buddy Sets within a currently open Buddy Group. This can be called
immediately prior to shutting down the process, or if the calling program wishes to
open a different buddy group to access other storage.
short CloseBuddyGroup (const char *pBuddyGroupName // input
);
Return Value:
0 = Successful
112 = Failed - Buddy Group not found
116 = Failed - Buddy Group not open
100 = a system error occurred (call GetSystemErrorString)
pBuddyGroupName:
is a 5 character alphanumeric name with no embedded spaces, for example:
GRP01 or B01
3.2.3 GetBuddyObject
Read a specified object from the currently open Buddy Group. An object can either be
read partially or fully by setting the appropriate API calling parameters.
To retrieve the full object content, set the Offset to zero and the Length to the length
of the object. If the calling application does not know the object length, it can simply
specify the maximum field value (ULONG_MAX) for the length, and the API returns
the full object together with its correct length.
To retrieve a partial object, the caller specifies the offset and length as required. The
API reads from many bytes into the object, where the Offset is specified (non-zero)
and again, the length can be either a valid number of bytes or ULONG_MAX to
indicate that the remainder of the message is to be read.
The API allocates memory to *ppaBuffer on success, and so the calling application
must free it after retrieval.
short GetBuddyObject (long long ObjectId // input
, unsigned long ByteOffset // input
, unsigned long *pObjectLength //
input/output
, char **ppaBuffer // output
);
Return Value:
0 = Successful
116 = Failed - Buddy Group not open
Page 11 of 37