L_EpnRemovePrinterFromList

#include "l_eprint.h"

L_INT EXT_FUNCTION L_EpnRemovePrinterFromList (hPrintersList, nIndex)

HEPNPRINTERSLIST hPrintersList;

/* handle to an existing printers list */

L_INT nIndex;

/* index */

Removes the printer at the specified index from the printers list.

Parameter

Description

hPrintersList

Handle to an existing printers list, created by calling the L_EpnCreatePrintersList function.

nIndex

A zero-based index of the printer to be removed from the printers list.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Support for Basic functionality must be unlocked by calling the L_EpnUnlockSupport function before using this function.

Required DLLs and Libraries

LPKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to ePrint Files.

See Also

Functions:

L_EpnSetPrinterBatchPrintersList, L_EpnGetPrinterBatchPrintersList, L_EpnCreateRedirectionDC, L_EpnGetPrintersCount, L_EpnCreatePrintersList, L_EpnDestroyPrintersList, L_EpnAddPrinterToList, L_EpnGetPrinterFromList, L_EpnIsPrinterInList

Topics:

ePrint: Printers list

 

Redirecting to a Printer Redirection List

Example

/* The hPrintersList passed should have already created HEPNPRINTERSLIST that created using the L_EpnCreatePrintersList function. */
L_VOID RemovePrinterFromList( HEPNPRINTERSLIST hPrintersList, L_CHAR * pszPrinterName ) 
{
   EPNBATCHPRINTERINFO Info; 
   ZeroMemory( & Info, sizeof( EPNBATCHPRINTERINFO ) ); 
   Info.uStructSize = sizeof( EPNBATCHPRINTERINFO ); 
   strcpy( Info.szPrinterName, pszPrinterName ); 
   L_INT nIndexOfPrinter = 0; 
   if( SUCCESS == L_EpnIsPrinterInList ( hPrintersList, & Info, & nIndexOfPrinter ) ) 
   {
      L_EpnRemovePrinterFromList( hPrintersList, nIndexOfPrinter ); 
   }
}