BSASendData
Send a byte stream of data in a buffer.
SYNOPSIS
#include <xbsa.h>
int BSASendData(BSA_Handle bsaHandle, BSA_DataBlock32 *dataBlockPtr)
DESCRIPTION
BSASendData() sends a byte stream of data to the NetBackup XBSA interface in a buffer. BSASendData() can be called multiple times, in case the byte stream of data to be sent is large. This call can be used only after a BSACreateObject() or another BSASendData() call.
PARAMETERS
BSA_Handle bsaHandle (I) | This parameter is the handle that associates this call with a previous BSAInit() call. |
BSA_DataBlock32 *dataBlockPtr (I) | This parameter is a pointer to a structure that includes a pointer to the buffer from which the data is to be sent, as well as the size of the buffer. |
EXTENDED DESCRIPTION
The NetBackup XBSA interface does not overwrite any of the fields in the BSA_DataBlock32 structure. The NetBackup XBSA interface can write into the header and trailer portions of the buffer. See Use of BSA_DataBlock32 in BSASendData().
RETURN VALUE
The following return codes are returned by this function:
BSA_RC_ABORT_SYSTEM_ERROR | System detected error, operation aborted. |
BSA_RC_INVALID_CALL_SEQUENCE | The sequence of API calls is incorrect. |
BSA_RC_INVALID_DATABLOCK | The BSA_DataBlock32 parameter contained an inconsistent value. |
BSA_RC_INVALID_HANDLE | The handle used to associate this call with a previous BSAInit() call is invalid. |
BSA_RC_NULL_ARGUMENT | A NULL pointer was encountered in one of the arguments. |
BSA_RC_SUCCESS | The function succeeded. |