HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001

pCallerTransAborted:

indicates whether the caller’s NonStop Transaction Management Facility

(TMF) transaction has been aborted. This is irrelevant if the caller has

allowed the API to start the transaction.

0 = not aborted

1 = aborted

3.2.5 AllocateBuddyObject

Allocates a storage area for a new Object, but doesn’t store the Object content. One

or more calls to PutBuddyObject subsequently store the Object content in the

allocated space. For the best performance, PutBuddyObject should then write in as

large chunks as possible to avoid unnecessary writes.

short AllocateBuddyObject (unsigned long ObjectLength //

input

, long long *pObjectId // output

, short *pCallerTransAborted //

output

);

Return Value:

0 = Successful

999 = Failed – transient error, please retry

116 = Failed – Buddy Group not open

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)

ObjectLength:

Is a 32 bit number representing the length of the Object to be stored.

ObjectId:

Is a 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.6 DeleteBuddyObject

Delete references to an object and free the associated storage.

short DeleteBuddyObject (long long ObjectId // input