Querying Fax Jobs

A fax client application can query the fax number related to a fax job, and fax recipient and sender information. You can also retrieve a job's type, status, and unique identifier; scheduling and billing information; and the transmission's page count.

In the Win32 Environment

The FaxEnumJobs function permits a fax client application to retrieve a list of the jobs in the fax job queue on a specified fax server. Call the FaxGetJob function to query an individual fax job. Both functions return detailed information for the jobs in FAX_JOB_ENTRY structures, one job per structure.

Because the FaxGetJob function and the FaxEnumJobs function allocate the memory required for FAX_JOB_ENTRY structures, the application must call the FaxFreeBuffer function to deallocate the resources.

Note that an application must call the FaxConnectFaxServer function to obtain a fax server handle before calling the FaxEnumJobs and FaxGetJob functions.

In the COM Implementation Environment

If you are writing a C/C++ application, after you create a FaxJob object for a specified fax job, you can call IFaxJob interface methods to query the properties of the job. For information about the steps required to create a FaxJob object, and for a list of properties and methods, see IFaxJob.

If you are writing a Visual Basic application, after you create a FaxJob object for a specified fax job, you can retrieve multiple properties of the object. See FaxJob object (Visual Basic) for more information about the steps required to create the object, and for a list of properties and methods of the object.