cwbOBJ_AnswerSplFMsg

Purpose

Answer the message that the spooled file is waiting on.

Syntax

 
unsigned int CWB_ENTRY  cwbOBJ_AnswerSplFMsg(
                               cwbOBJ_ObjHandle   splFHandle,
                               char              *msgAnswer,
                               cwbSV_ErrHandle    errorHandle);

Parameters

cwbOBJ_ObjHandle splFHandle - input

Handle of the spooled file to answer the message for.

const char *msgAnswer - input

Pointer to a ASCIIZ string that contains the answer for the message.

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

CWBOBJ_RC_INVALID_TYPE

Handle is not a spooled file handle.

CWBOBJ_RC_SPLFNOMESSAGE

The spooled file isn't waiting on a message.

Usage

None