Platform SDK: Fax Services |
A fax client application calls the FaxGetJob function to retrieve detailed information for the specified queued or active fax job. The function returns the information in a FAX_JOB_ENTRY structure.
BOOL WINAPI FaxGetJob( HANDLE FaxHandle, // handle to the fax server DWORD JobId, // fax job identifier PFAX_JOB_ENTRY *JobEntry // pointer to job data structure );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError. GetLastError can return one of the following errors.
Error code | Description |
---|---|
ERROR_ACCESS_DENIED | Access is denied. FAX_JOB_QUERY access is required. |
ERROR_INVALID_PARAMETER | The JobId parameter is invalid, or one or both of the JobEntry or FaxHandle parameters are NULL. |
ERROR_NOT_ENOUGH_MEMORY | An error occurred during memory allocation. |
The FaxGetJob function retrieves information about an individual fax job. To retrieve information about all queued and active jobs on the fax server of interest, call the FaxEnumJobs function.
The FaxGetJob function allocates the memory required for the buffer pointed to by the JobEntry parameter. An application must call the FaxFreeBuffer function to deallocate the resources associated with this parameter.
For more information, see Managing Fax Jobs and Freeing Fax Resources.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable with BackOffice Small Business Server.
Header: Declared in Winfax.h.
Library: Included as a resource in Winfax.dll.
Unicode: Implemented as Unicode and ANSI versions on all platforms.
Fax Service Client Application Programming Interface Overview, Fax Service Client API Functions, FaxFreeBuffer, FaxEnumJobs, FaxSetJob, FaxConnectFaxServer, FAX_JOB_ENTRY