Platform SDK: Fax Services

IFaxJob::get_PageCount

The IFaxJob::get_PageCount method retrieves the PageCount property for a FaxJob object. The PageCount property is a number that represents the total number of pages in a fax transmission. The PageCount property applies only to outgoing fax transmissions.

Visual Basic Reference

HRESULT get_PageCount(
  LONG *pVal  // receives total page count
);

Parameters

pVal
[out] Pointer to a numeric value that is the total page count for the specified outbound 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

The total page count is only available for faxes that have a Type property equal to JT_SEND. If the page count is not available, the IFaxJob::get_PageCount method returns zero.

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_Type