FaxDevEndJob function (faxdev.h)

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

Syntax

BOOL FaxDevEndJob(
  [in] HANDLE FaxHandle
);

Parameters

[in] FaxHandle

Type: HANDLE

Specifies a fax handle returned by the FaxDevStartJob function.

Return value

Type: BOOL

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 FSP 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 FaxDevEndJob, it will also call the FaxDevEndJob function, even if an operation has been terminated by the FaxDevAbortOperation function.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	faxdev.h

See also

Fax Service Provider Functions

FaxDevAbortOperation

FaxDevStartJob

Using the Fax Service Provider API