ZfxRushMsg and ZfxRushMsgEx
Request server to stop processing message.
Syntax
ZFERR FAR ZfxRushMsg( ZFSESSIONHANDLE hSession, ZFMSGDIR MsgDir, char FAR *lpszBody)
ZFERR FAR ZfxRushMsgEx( ZFSESSIONHANDLE hSession, ZFMSGDIR MsgDir, char FAR *lpszBody, char FAR *lpszMsgID)
Parameters
Parameter |
Description |
Hsession |
API session handle, as returned by ZfxAPIInit call MsgDir Message type (ZFDIR_OUT) |
lpszBody |
Base name of message file |
lpszMsgID |
Message ID |
Description
These routines are called to request the server rush the processing a message after it has been submitted using ZfxSendMsgEx. The routine sends a request to the Zetafax server, which processes it asynchronously.
Return value
The routine returns 0 if successful, otherwise one of the following:
ZFERR_NOT_INITIALISED
ZFERR_INVALID_PARAMETERS
ZFERR_UNKNOWN_MESSAGE
ZFERR_SERVER_NOT_RUNNING
ZFERR_CANNOT_SUBMIT_REQUEST
Example
#include <stdio.h>
#include <zfapi.h>
...
if (ZfxRushMsg(hSession, ZFDIR_OUT, "~XSND000") == 0)
{
printf("Message rushed");
/* server should now speed up the */
/* processing of the message */
/* now wait for status to change to */
/* ZFMSG_OK or ZFMSG_FAILED before */
/* deleting the message */
...
}
Related topics