PrinterSettings.GetHdevmode Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Creates a handle to a DEVMODE structure that corresponds to the printer settings.

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

public IntPtr GetHdevmode()

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