HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001
120 = Failed – Object Id not found
121 = Failed – Object Offset and/or Length invalid or out of range
100 = a system error occurred (call GetSystemErrorString)
ObjectId:
is a unique 64 bit number to identify an object – previously returned by
PutBuddyObject or AllocateBuddyObject.
ByteOffset:
is a 32 bit number representing the starting point for extraction of the Object.
ObjectLength:
is a 32 bit number representing the number of bytes to be extracted. If the
length of the Object is unknown, or all the Object is to be extracted the value
can be set to ULONG_MAX.
ppaBuffer:
A pointer to the address of the return buffer containing the Object content.
3.2.4 PutBuddyObject
Store a new object in the currently open Buddy Group. If a complete new Object is to
be stored, set ObjectId to zero and Offset to zero. While storing data to an existing
Object, set the ObjectId, Offset and Length according to the chunk to be stored in this
operation.
short PutBuddyObject (long long *pObjectId // input/output
, unsigned long ByteOffset // input
, unsigned long ObjectLength // input
, char *paBuffer // input
, short *pCallerTransAborted // output
);
Return value:
0 = Successful
999 = Failed – transient error, please retry
116 = Failed – Buddy Group not open
120 = Failed – Object Id not found
121 = Failed – Object Offset and/or Length invalid or out of range
122 = Failed – Insufficient Storage in the input buffer
150 = Failed – No BuddySets available to store object
100 = a system error occurred (call GetSystemErrorString)
pObjectId:
is a pointer to a unique number to identify an Object. If storing an Object
without Allocating previously, set *pObjectId to zero. If AllocateBuddyObject
had previously been called supply the Id returned by AllocateBuddyObject.
ObjectOffset:
is a 32 bit number representing the offset within the Object that this chunk
should be written at.
ObjectLength:
is a 32 bit number representing the number of bytes to be stored.
paBuffer:
The buffer containing the content to be written in this operation.
Page 12 of 37