cwbOBJ_WriteNewSplF

Purpose

Writes data into a newly created spooled file.

Syntax

 
unsigned int CWB_ENTRY cwbOBJ_WriteNewSplF(
                              cwbOBJ_ObjHandle  newSplFHandle,
                              const char       *data,
                              unsigned long     dataLen,
                              cwbSV_ErrHandle   errorHandle);

Parameters

cwbOBJ_ObjHandle newSplFHandle - input

New spooled file handle. This is the handle passed back on the cwbOBJ_CreateNewSplF() API.

const char *data - input

Pointer to the data buffer that will be written into the spooled file.

unsigned long ulDataLen - input

Length of the data to be written.

cwbSV_ErrHandle errorHandle - output

Optional, may be 0. Any returned messages will be written to this object. It is created with the cwbSV_CreateErrHandle() API. The messages may be retrieved through the cwbSV_GetErrText() API. If the parameter is set to zero, no messages will be retrievable.

Return Codes

The following list shows common return values.

CWB_NO_ERROR

Successful completion.

CWB_NOT_ENOUGH_MEMORY

Insufficient memory.

CWB_INVALID_HANDLE

Handle is not valid spooled file handle.

CWBOBJ_RC_HOST_ERROR

Host error occurred. Text may be in errorHandle.

Usage

None