FaxCompleteJobParams (winfax)
Last changed: -86.198.32.112

.
Summary
Creates a FAX_COVERPAGE_INFO structure and a FAX_JOB_PARAM structure for a fax client application.

C# Signature:

[DllImport("winfax.dll", SetLastError = true, EntryPoint = "FaxCompleteJobParamsW")]
static extern bool FaxCompleteJobParams (out IntPtr JobParams, out IntPtr CoverpageInfo);

//If you use FAX_JOB_PARAM and FAX_COVERPAGE_INFO as a CLASS !
[DllImport("winfax.dll", SetLastError = true, EntryPoint = "FaxCompleteJobParamsW")]
static extern bool FaxCompleteJobParams (out FAX_JOB_PARAM JobParams, out FAX_COVERPAGE_INFO CoverpageInfo);

VB Signature:

Declare Function FaxCompleteJobParams Lib "winfax.dll" (TODO) As TODO

User-Defined Types:

None.

Notes:

Be careful ! Don't miss the EntryPoint attribute, beacause string in structures will be in bad format (ANSI).
Use Marshal.GetLastWin32Error() function to get the last error if the function return false.

Tips & Tricks:

I advice you that you declare FAX_JOB_PARAM and FAX_COVERPAGE_INFO as a CLASS !

Sample Code:

//Use this sample code with FAX_JOB_PARAM and FAX_COVERPAGE_INFO as a CLASS !
FAX_JOB_PARAM job;
FAX_COVERPAGE_INFO cover;

if (FaxCompleteJobParams(out job, out cover) == true))
{
    //You can now use, job and cover classes...
}

IntPtr pJob;
IntPtr pCover;

if (FaxCompleteJobParams(out pJob, out pCover) == true))
{
    FAX_JOB_PARAM job;
    FAX_COVERPAGE_INFO cover;    

    job = (FAX_JOB_PARAM)Marshal.PtrToStructure(pJob, typeof(FAX_JOB_PARAM));
    cover = (FAX_COVERPAGE_INFO)Marshal.PtrToStructure(pCover, typeof(FAX_COVERPAGE_INFO));

    //You can now use, job and cover structures...
}

Contact me

Gilles TOURREAU (French)
gilles.tourreau@microgil.com

Revisions

03-10-2006 : (By Gilles TOURREAU)
- Add function syntax with using classes
- Add 2 samples
- Add notes and tips

Alternative Managed API:

Do you know one? Please contribute it!

Documentation