Platform SDK: Fax Services |
The FaxCompleteJobParams function creates both a FAX_COVERPAGE_INFO structure and a FAX_JOB_PARAM structure for a fax client application. This utility function supplies multiple members of these structures with values for the size of the structure, the sender's name, and optional billing code information.
BOOL WINAPI FaxCompleteJobParams( PFAX_JOB_PARAM *JobParams, // pointer to // job information structure PFAX_COVERPAGE_INFO *CoverpageInfo // pointer to // cover page structure );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
The fax client application should call the FaxCompleteJobParams function before calling the FaxSendDocument function. This enables the fax server to provide any values that are available for the members of the FAX_JOB_PARAM and the FAX_COVERPAGE_INFO structures. The application should not query the user's registry for this information because the location of the information can change. For more information, see Transmitting Faxes.
The application must call the FaxFreeBuffer function once to deallocate the buffer pointed to by the JobParams parameter, and again to deallocate the buffer pointed to by the CoverpageInfo parameter. For more information, see Freeing Fax Resources.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable with BackOffice Small Business Server.
Header: Declared in Winfax.h.
Library: Included as a resource in Winfax.dll.
Unicode: Implemented as Unicode and ANSI versions on all platforms.
Fax Service Client Application Programming Interface Overview, Fax Service Client API Functions, FaxSendDocument, FaxFreeBuffer, FAX_COVERPAGE_INFO, FAX_JOB_PARAM