DEVNAMES

This structure contains strings that identify the driver, device, and output port names for a printer. The PageSetupDlg function uses these strings to initialize the system-defined Print property sheet or Print dialog box. When the user closes the property sheet or dialog box, information about the selected printer is returned in this structure.

typedef struct tagDEVNAMES {
WORD wDriverOffset; 
WORD wDeviceOffset; 
WORD wOutputOffset; 
WORD wDefault; 
} DEVNAMES; 

Members

  • wDriverOffset
    (In/Out) Specifies the offset in bytes from the beginning of this structure to a null-terminated string that contains the file name (without the extension) of the device driver. On input, this string is used to determine the printer to display initially in the dialog box.

  • wDeviceOffset
    (In/Out) Specifies the offset in bytes from the beginning of this structure to the null-terminated string that contains the name of the device.

  • wOutputOffset
    (In/Out) Specifies the offset in bytes from the beginning of this structure to the null-terminated string that contains the device name for the physical output medium (output port).

  • wDefault
    (In/Out) Specifies whether the strings contained in the DEVNAMES structure identify the default printer. This string is used to verify that the default printer has not changed since the last print operation. If any of the strings do not match, a warning message is displayed informing the user that the document may need to be reformatted.

    On output, the wDefault member is changed only if the Print Setup dialog box was displayed and the user chose the OK button. The DN_DEFAULTPRN flag is used if the default printer was selected. If a specific printer is selected, the flag is not used. All other flags in this member are reserved for internal use by the dialog box procedure for the Print property sheet or Print dialog box.

Remarks

The PageSetupDlg function fills this structure with byte offsets rather than character offsets.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.10 and later Commdlg.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

DEVMODE, PageSetupDlg, PAGESETUPDLG

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.