IFaxServer::put_Retries

The IFaxServer::put_Retries method changes the Retries property for a FaxServer object. The Retries property is a value that represents the number of times the fax server attempts to retransmit an outgoing fax when the initial transmission fails.

Visual Basic Reference

HRESULT put_Retries(
  LONG newVal  // new value for number of retransmission attempts
);

Parameters

newVal

[in] Specifies the new value to assign to the Retries property.

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

A fax client application can set the Retries property equal to zero to indicate that the fax server should not attempt to retransmit an outbound fax job if the first transmission fails.

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, IFaxServer, IFaxServer::get_Retries