gfqFindFirst( )

Description | Example

Name:	int gfqFindFirst (GFQCHAR *gfqFileName, GFQRECORD *pQRec, GFQINT Link, GFQINT End, GFQCHAR *User);
Inputs:	GFQCHAR *gfqFileName	Name of Queue File access.
	GFQRECORD *pQRec	Queue record buffer.
	GFQINT Link	Link list to be read.
	GFQINT End	The end from which to begin - GFQLIST_START or GFQLIST_END.
	GFQCHAR *User	Valid queue record, if return is GFQSUCCESS.
Outputs:	GFQRECORD *pQRec	Valid queue record, if return is GFQSUCCESS.
Returns:	GFQSUCCESS	A valid record was found.
	GFQLIST_NOTFOUND	The link specified was not valid.
	GFQLIST_EOF	No records matching the search values were found.
	GFQRECORD_NOTFOUND	List is empty.
Includes:	gfq.h

Description

The gfqFindFirst( ) function locates the first item in a list using the user ID, and the direction it was passed to determine which record is the first. That record is then read into the buffer pointed to by pQRec.

Example

#include "gfq.h"  
#include "gfqpath.h"  
int status;  
GFQRECORD qrec;  
GFQCHAR gfqFileName[GFQFILENAME_SIZE];  
int i=0;  
if (gfqSearch(GFQDIR_QUEUE, "gfax.$qu", gfqFileName)){  
  printf("Error getting path to queue file.\n");  
  exit(1);  
}  
status = gfqFindFirst(gfqFileName, &qrec, GFQPEND_LIST, GFQLIST_START,"");  
if (status == GFQSUCCESS){  
    printf("Record %d on Pending list\n", ++i);  
    printf("\t Phone = %s\n", qrec.phone_no);  
    printf("\t Send file = %s\n", qrec.fn_send);
  
}

Click here to contact Dialogic Customer Engineering