Share via


FORMPRINTSETUP

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Describes the print setup information for the form object.

Header file:

Mapiform.h

typedef struct
{
  ULONG ulFlags;
  HDEVMODE hDevMode;
  HDEVNAMES hDevNames;
  ULONG ulFirstPageNumber;
  ULONG ulFPrintAttachments;
} FORMPRINTSETUP, FAR * LPFORMPRINTSETUP;

Members

  • ulFlags
    Bitmask of flags that controls the type of the strings. The following flag can be used:

    • MAPI_UNICODE
      The strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.
  • hDevmode
    Handle to the mode of the printer.

  • hDevnames
    Handle to the path of the printer.

  • ulFirstPageNumber
    Page number of the first page to be printed.

  • ulFPrintAttachments
    Flag that indicates whether there are attachments to be printed. If there are attachments to print, the ulFPrintAttachments member is set to 1. If there are no attachments to print, it is set to 0.

Remarks

The FORMPRINTSETUP structure is used to describe the print setup information for a form object. Implementations of IMAPIViewContext::GetPrintSetup fill in the FORMPRINTSETUP structure and return it in the contents of the lppFormPrintSetup output parameter of GetPrintSetup.

If the MAPI_UNICODE flag is passed in the ulFlags parameter of GetPrintSetup, the strings referenced by the hDevmode and hDevnames members should be in Unicode format. Otherwise, the strings should be in ANSI format.

Form viewers implementing IMAPIViewContext must allocate the FORMPRINTSETUP structure using the MAPI allocator function MAPIAllocateBuffer, but allocate the individual members, hDevMode and hDevNames, with the Windows function GlobalAlloc. The release of memory is handled similarly. The hDevMode and hDevNames members must be freed using the Windows function GlobalFree whereas the FORMPRINTSETUP structure must be freed with the MAPIFreeBuffer function.

See Also

Reference

IMAPIViewContext::GetPrintSetup

MAPIFreeBuffer

MAPIAllocateBuffer

Concepts

MAPI Structures