Platform SDK: Fax Services |
The IFaxPort::put_FileName method changes the FileName property for a FaxDoc object. The FileName property is a null-terminated string that contains the name of the document file associated with the object.
HRESULT put_FileName( BSTR newVal // new value for file name );
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 FileName property is required to send a fax transmission using a call to the IFaxDoc::Send method. For more information, see Transmitting 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, IFaxDoc, IFaxDoc::get_FileName