FaxDevEndJob

The fax service calls the FaxDevEndJob function after the last fax operation in a fax job. Each fax service provider must export the FaxDevEndJob function.

BOOL WINAPI FaxDevEndJob(
  HANDLE FaxHandle       // fax handle 
);

Parameters

FaxHandle

[in] Specifies a fax handle returned by the FaxDevStartJob function.

Return Values

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, the fax service calls GetLastError.

Remarks

The fax service provider should perform necessary cleanup tasks for the fax job when the fax service calls FaxDevEndJob. Cleanup should include deallocation of memory for any job-specific instance data that was allocated in the call to the FaxDevStartJob function.

Note that if the fax service calls FaxDevStartJob, it will also call the FaxDevEndJob function, even if an operation has been terminated by the FaxDevAbortOperation function.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxdev.h.
  Import Library: User-defined.

See Also

Fax Service Provider Application Programming Interface Overview, Fax Service Provider Functions, FaxDevStartJob, FaxDevAbortOperation