FAX_CONTEXT_INFO

The FAX_CONTEXT_INFO structure contains information about a fax printer device context. The SizeOfStruct member is required. Information for the other members is supplied by a call to the FaxStartPrintJob function.

typedef struct _FAX_CONTEXT_INFO {
  DWORD SizeOfStruct;  // structure size, in bytes
  HDC   hDC;           // handle to a device context
  TCHAR ServerName[MAX_COMPUTERNAME_LENGTH+1]; 
                       // server name
} FAX_CONTEXT_INFO, *PFAX_CONTEXT_INFO; 

Members

SizeOfStruct

Specifies the size, in bytes, of the FAX_CONTEXT_INFO structure. The calling application must set this member to sizeof(FAX_CONTEXT_INFO) before it calls the FaxStartPrintJob function.

hDC

Handle to a fax printer device context. A call to the FaxStartPrintJob function supplies the data for this member.

ServerName

Specifies a variable that contains a null-terminated string that is the fax server name of interest. A call to the FaxStartPrintJob function supplies the data for this member. If the fax server is on the local computer, this member will be empty. The client application does not need to fill in this member.

Remarks

A fax client application can call the FaxStartPrintJob function to retrieve the handle to a fax printer device context. The function returns the handle in a FAX_CONTEXT_INFO structure. The application must call the DeleteDC function to deallocate the handle to the printer device context. For more information, see Printing a Fax to a Device Context.

Requirements

  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.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Fax Service Client Application Programming Interface Overview, Fax Service Client API Structures, FaxStartPrintJob, FaxPrintCoverpage, EndDoc, DeleteDC