Platform SDK: Fax Services

FaxDevAbortOperation

The fax service calls the FaxDevAbortOperation function to request that the fax service provider terminate the active fax operation for the fax job specified by the FaxHandle parameter. Each fax service provider must export the FaxDevAbortOperation function.

BOOL WINAPI FaxDevAbortOperation(
  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 FaxDevAbortOperation function is called asynchronously on an execution thread that is independent of the fax operation. It is usually necessary to synchronize access by multiple threads. For more information, see Synchronizing Execution of Multiple Threads.

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, FaxDevEndJob