DEVNAMES

typedef struct tagDEVNAMES { /* dvnm */

WORD wDriverOffset;

WORD wDeviceOffset;

WORD wOutputOffset;

WORD wDefault;

/* driver, device, and port-name strings follow wDefault */

} DEVNAMES;

The DEVNAMES structure contains strings that identify the driver, name, and output port of a printer. The PrintDlg function uses these strings to initialize fields in the system-defined print dialog box. When the user dismisses the dialog box, information about the selected printer is returned in this structure.

Members

wDriverOffset

(Input/Output) Specifies the offset to a null-terminated string that specifies the DOS filename (without extension) of the device driver. On input, this string is used to determine the printer to initially display in the dialog.

wDeviceOffset

(Input/Output) Specifies the offset to the null-terminated string (maximum of 32 bytes including the null) that specifies the name of the device. This string must be identical to the dmDeviceName member of the DEVMODE structure.

wOutputOffset

(Input/Output) Specifies the offset to the null-terminated string that specifies the DOS device name for the physical output medium (output port).

wDefault

Specifies whether the strings specified in the DEVNAMES structure identify the default printer. It is used to verify that the default printer has not changed since the last print operation. On input, if the DN_DEFAULTPRN flag is set, the other values in the DEVNAMES structure are checked against the current default printer. 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 pressed the OK push button. The DN_DEFAULTPRN flag is set if the default printer was selected. If a printer is specifically selected, the flag is not set. All other bits in this member are reserved for internal use by the print dialog procedure.

See Also

PrintDlg