IFaxJob::SetStatus method (faxcom.h)

Call the IFaxJob::SetStatus method to pause, resume, cancel, or restart a specified fax job.

Syntax

HRESULT SetStatus(
  [in] long Command
);

[in] Command

Type: LONG

Specifies a LONG variable that indicates the job command to perform. This parameter can be one of the following values.

Cancel the specified fax job. The job can be active or queued.

Pause the specified queued fax job. If the fax job is active, the fax service pauses the job when it returns to the queued state.

Resume the paused fax job.

Restart the specified fax job.

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

You can use the IFaxJob::get_QueueStatus property to retrieve the job queue status of a fax job.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	faxcom.h
DLL	Faxcom.dll