Veritas NetBackup™ DataStore SDK Programmer's Guide for XBSA 1.1.0
- Introduction to NetBackup XBSA
- How to set up the SDK
- Using the NetBackup XBSA interface
- NetBackup XBSA data structures
- NetBackup XBSA environment
- XBSA sessions and transactions
- Creating a NetBackup XBSA application
- Initiating a session
- Backup - creating an object
- Query - finding an object descriptor
- Restore - retrieving an object's data
- Delete - deleting an object or image
- Media IDs - obtaining media IDs
- How to build an XBSA application
- How to run a NetBackup XBSA application
- About How to run a NetBackup XBSA application
- API reference
- Function calls
- Function specifications
- Type definitions
- Process flow and troubleshooting
- How to use the sample files
- Support and updates
- Appendix A. Register authorized locations
Get a byte stream of data using buffers.
int BSAGetData(BSA_Handle bsaHandle, BSA_DataBlock32 *dataBlockPtr)
BSAGetData() allows the caller to request a buffer full of XBSA object data from the NetBackup XBSA interface. This call is used after a BSAGetObject() call or after other BSAGetData() calls.
BSA_Handle bsaHandle (I)
This parameter is the handle that associates this call with a previous BSAInit() call.
BSA_DataBlock32 *dataBlockPtr (I/O)
This parameter is a pointer to a structure that includes both a pointer to the buffer for the data that is to be received and the size of the buffer. Further, the API returns, in this structure, the number of bytes of data that have been sent to the caller for this call.
The NetBackup XBSA interface overwrites the numBytes field to provide the actual values used. The NetBackup XBSA interface does not modify any other fields. The XBSA application can only use the data portion of the buffer in which the XBSA object data is contained.
The following return codes are returned by this function:
System detected error, operation aborted.
The sequence of API calls is incorrect.
The BSA_DataBlock32 parameter contained an inconsistent value.
The handle used to associate this call with a previous BSAInit() call is invalid.
There is no more data.
A NULL pointer was encountered in one of the arguments.
The function succeeded.