ZfxRestartServer
Restart the Zetafax server.
Syntax
ZFERR FAR ZfxRestartServer( ZFSESSIONHANDLE hSession, SHORT fReserved)
Parameters
Parameter |
Description |
hSession |
API session handle, as returned by by ZfxAPIInit call |
fReserved |
Reserved - set to FALSE (0) |
Description
This routine requests the Zetafax server to restart if already running. This is equivalent to ZfxStopServer followed by ZfxStartServer, but can be called from any machine (unlike ZfxStartServer which must be called on the fax server PC).
When the server programs restart, they re-read the initialization files and settings. ZfxRestartServer can therefore be used after making changes to the server settings, such as adding or removing fax devices. Note however that restarting the server will abort any faxes currently being sent or received.
Return value
The routine returns 0 if successful, otherwise one of the following:
ZFERR_NOT_INITIALISED
ZFERR_SERVER_NOT_RUNNING
Example
#include <stdio.h>
#include <zfapi.h>
...
Err = ZfxRestartServer(hSession, FALSE);
if (Err == 0)
{
printf("Server restarting\n"); }
else
{
printf("Unable to restart server\n");
}
Related topics