PrinterSettings.GetHdevmode Method (PageSettings)


Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

Namespace:   System.Drawing.Printing
Assembly:  System.Drawing (in System.Drawing.dll)

public IntPtr GetHdevmode(
	PageSettings pageSettings


Type: System.Drawing.Printing.PageSettings

The PageSettings object that the DEVMODE structure's handle corresponds to.

Return Value

Type: System.IntPtr

A handle to a DEVMODE structure.

Exception Condition

The printer named in the PrinterName property does not exist.


The printer's initialization information could not be retrieved.

DEVMODE structures are device specific. Copying a DEVMODE structure from one PrinterSettings to a PrinterSettings for a different printer is not supported.

When you are done with the handle that is created through this method, you must deallocate it yourself by calling the native Win32 GlobalFree method. When you call this method, you pass as a parameter the return value from the GetHdevmode method.


for printing and access to all printers on the network. Associated enumeration: PrintingPermissionLevel.AllPrinting

.NET Framework
Available since 1.1
Return to top