Please use FireFox to view this page

Visual Basic 6 definition

Declare Function EnumPrinters Lib "winspool.drv" Alias "EnumPrintersA" (ByVal flags As Long, ByVal name As String, ByVal Level As Long, pPrinterEnum As Long, ByVal cdBuf As Long, pcbNeeded As Long, pcReturned As Long) As Long

Visual Basic .NET definition

Declare Function EnumPrinters Lib "winspool.drv" Alias "EnumPrintersA"(ByVal flags As Integer, ByVal name As String, ByVal Level As Integer, ByRef pPrinterEnum As Byte, ByVal cdBuf As Integer, ByRef pcbNeeded As Integer, ByRef pcReturned As Integer) As Integer

C# definition

[DllImport("winspool.drv", EntryPoint="EnumPrinters")] public static extern int EnumPrintersA(int flags, string name, int Level, ref byte pPrinterEnum, int cdBuf, ref int pcbNeeded, ref int pcReturned)

Description

Platforms: Win 95/98, Win NT EnumPrinters finds and returns information about one or more printers which the computer has access to. These include both local printers (physically connected to the machine) and network printers (accessible via the network). Under Win 95/98, the information can be passed in a PRINTER_INFO_1, PRINTER_INFO_2, or PRINTER_INFO_5 structure. Under Win NT, the information can be passed in a PRINTER_INFO_1, PRINTER_INFO_2, or PRINTER_INFO_4 structure. Note that structures 4 and 5 are the quickest ones to use. The attributes of the chosen structure determine what kinds of information about the printer(s) is returned. The information itself is put into the array passed as pPrinterEnum, which can then be copied into an array of data structures. The function returns 1 if successful, or 0 if an error occured. Note for Visual Basic users: Due to limitations in the Visual Basic language, it is impossible to pass an array of PRINTER_INFO_* structures as pPrinterEnum -- the array must be of Long-type elements. Also, for some reason the CopyMemory function cannot be used to successfully transfer the array information into the structure. Instead, each individual member of the data structure must be set manually. Look at the two examples for details how. In order to convert a Long-type string pointer (in the array) to a string, variants of the lstrcpy and lstrlen function must be used. Again, see the examples. CopyMemory, however, can be used to copy the data structures which make up parts of the PRINTER_INFO_2 data structure. EnumPrinters Enumerates available printers, print servers, domains, or print providers. System.Drawing.Printing.PrinterSettings.InstalledPrinters

Parameters

flags One or more of the following flags specifying which printers to find information about (note that PRINTER_ENUM_LOCAL and PRINTER_ENUM_CONNECTIONS are the only valid flags when using PRINTER_INFO_4): PRINTER_ENUM_CONNECTIONS = &H4 Win NT only: Get information about the network printers which the computer has made connections to. PRINTER_ENUM_DEFAULT = &H1 Win 95/98 only: Get information about the computer's default printer. PRINTER_ENUM_LOCAL = &H2 Get information about local printers (the ones directly connected to the system). Win 95/98 for some reason also considers network printers to be local. PRINTER_ENUM_NAME = &H8 Get information about all the printers under the network domain specified by name. PRINTER_ENUM_NETWORK = &H40 Win NT only: Get information about all the printers under the computer's domain in the network. This only works with the PRINTER_INFO_1 structure. PRINTER_ENUM_REMOTE = &H10 Win NT only: Same as PRINTER_ENUM_NETWORK. PRINTER_ENUM_SHARED = &H20 Get information about all the printers with the shared attribute.

Further Information:

For further information on Windows API functions such as these, and how to use these API's in your C# and VB.NET applications, please refer to the book 'Network programming in .NET' (Buy at Amazon UK) (Buy at Amazon US)

Visual Basic 6 example source code

Visual Basic .NET example source code

C# example source code

Provide a code example

C#
VB.NET
VB6