Platform SDK: Fax Services |
The IFaxPort::put_Send method changes the Send property for a FaxPort object. The Send property is a Boolean value that indicates whether a fax port is enabled to send faxes.
Before calling this method a fax client application can call the IFaxPort::get_CanModify method to ensure that the client has permission to modify configuration information for the specified fax port.
HRESULT put_Send( BOOL newVal // new value for send enabled/disabled flag );
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.
The IFaxPort::get_Send method returns a value of TRUE if the fax port is enabled to send faxes. If a fax client application passes a value of TRUE to the IFaxPort::put_Send method, that method enables the fax port to send faxes.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Unsupported.
Header: Declared in faxcom.h.
Import Library: Included as a resource in faxcom.dll.
Fax Service Client Application Programming Interface Overview, Fax Service Client API Interfaces, IFaxPort, IFaxPorts, IFaxPort::get_Send, IFaxPort::CanModify