Platform SDK: Fax Services

IFaxJob::get_JobId

The IFaxJob::get_JobId method retrieves the JobId property for a FaxJob object. The JobId property is a number that uniquely identifies the specified fax job.

Visual Basic Reference

HRESULT get_JobId(
  LONG *pVal  // receives fax job identifier
);

Parameters

pVal
[out] Pointer to a numeric value that uniquely identifies the fax job.

Return Values

Returns an HRESULT value indicating success or failure. If the method succeeds, it returns S_OK. Otherwise, it returns a COM-defined error code.

You should not check directly for success or failure. Use the COM SUCCEEDED and FAILED macros instead.

Remarks

You can use the JobId property to uniquely identify a fax job because it is possible for multiple fax jobs to have the same DisplayName property. Note that the fax job identifier can be different from the identifier of a fax print job.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxcom.h.
  Import Library: Included as a resource in faxcom.dll.

See Also

Fax Service Client Application Programming Interface Overview, Fax Service Client API Interfaces, IFaxJob, IFaxJobs, IFaxJob::get_DisplayName