IFaxDoc::put_FileName method (faxcom.h)

Article
07/27/2022

Sets or retrieves 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.

This property is read/write.

Syntax

HRESULT put_FileName(
  BSTR newVal
);

Parameters

newVal

Return value

None

Remarks

The FileName property is required to send a fax transmission using a call to the IFaxDoc::Send method. For more information, see Transmitting Faxes.

The get_FileName method allocates the memory required for the buffer pointed to by the pVal parameter. The client application must call the SysFreeString function to deallocate the resources associated with this parameter. For more information, see Freeing Fax Resources.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	faxcom.h
DLL	Faxcom.dll