<< Click to Display Table of Contents >>

 

zetafax_logo

ZfxStartServer

 


 

Start the Zetafax server on this PC.

 

Syntax

 

ZFERR FAR ZfxStartServer( ZFSESSIONHANDLE hSession, SHORT fReserved, char FAR  *lpszReserved)

 

Parameters

 

Parameter

Description

hSession

API session handle, as returned by ZfxAPIInit call

fReserved

Reserved - set to FALSE (0)

lpszReserved

Reserved - set to NULL

 

Description

 

This routine starts the Zetafax server on the current PC. The PC must have been  correctly configured to run the server. The server programs are started in  turn. This routine returns once the server has begun starting, but the calling  application should then use the ZfxCheckServer routine to  determine when it has started.

 

Return value

 

The routine returns 0 if successful, otherwise one of the following:  

 

ZFERR_NOT_INITIALISED

ZFERR_INVALID_PARAMETERS

ZFERR_SERVER_RUNNING

ZFERR_CANNOT_RUN_SYSTEM_MANAGER

ZFERR_ERROR_STARTING_SERVER

 

Example

 

#include <stdio.h>

#include <zfapi.h>

...

 

Err = ZfxStartServer(hSession, FALSE, NULL);

 

if (Err == 0)

{

 printf("Server starting\n");

}

else

{

 printf("Unable to start server\n");

}

 

Related topics

Alphabetical reference

Function error returns and reference