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
Return the last system error code.
int BSAGetLastError(BSA_UInt32 *sizePtr, char *errorCodePtr)
The BSAGetLastError() call returns a textual description of the last error encountered by the NetBackup XBSA interface. It is used to return the NetBackup-specific information that describes the underlying cause of the failure of the most recent XBSA call; for example, a network failure.
BSA_UInt32 sizePtr (I/O)
This parameter contains the size of the error buffer in bytes.
char *errorPtr (O)
This parameter is a pointer to a data area that contains a text string describing the last error encountered.
If the NetBackup XBSA interface sets the sizePtr parameter to zero, it is unable to return a string describing the last error. This indicates that the NetBackup XBSA interface has no record of what error occurred.
If a BSA_RC_BUFFER_TOO_SMALL error is encountered, the required size is returned in the sizePtr parameter. If the XBSA application sets the sizePtr parameter to zero, this forces a BSA_RC_BUFFER_TOO_SMALL error that provides a mechanism to query the required size.
The following return codes are returned by this function:
The size of the data buffer is invalid.
The sequence of API calls is incorrect.
The handle used to associate this call with a previous BSAInit() call is invalid.
A NULL pointer was encountered in one of the arguments.
The function succeeded.