gfqFindNext( )

Description | Example

Name:	int gfqFindNext (GFQCHAR *gfqFileName, GFQRECORD *pQRec, GFQINT Direction, GFQCHAR *User)
Inputs:	GFQCHAR *gfqFileName	Name of queue file to access.
	GFQRECORD *pQRec	Queue record buffer.
	GFQINT Direction	Direction to read from current. Values are GDQREAD_FWD and GFQREAD_BWD
	GFQCHAR *User	User id string or "" for all.
Outputs:	None
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_NOT_FOUND	The list is empty.
	GFQRECORD_KEY_ERROR	The key information in the queue record has been modified since it was retrieved.
	GFQRECORD_INV_READ_DIR	Direction specified was unrecognized.
Includes:	gfq.h

Description

The gfqFindNext( ) function reads the next record in the specified direction, verifies the record passed in from the application has not changed, then it finds the next record in a list. Using the User parameter will limit the search of valid records.

Example

#include "gfq.h"  
#include "gfqpath.h"  
int status;  
GFQRECORD qrec;  
GFQCHAR gfqFileName[GFQFILENAME_SIZE];  
int i=0;  
if (gfqSearch(GFQDIR_QUEUE, "qfax.$qu", gfqFileName)){  
  printf("Error getting path to queue file.\n");  
  exit(1);  
}  
status = gfqFindFirst(gfqFileName, &qrec, GFQPEND_LIST, GFQLIST_START,"");  
while (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);  
  status = gfqFindNext(gfqFileName, &qrec, GFQREAD_FWD,"");  
}

Click here to contact Dialogic Customer Engineering