PRINTPROVIDOR structure

The PRINTPROVIDOR structure is used as a parameter to a print provider's InitializePrintProvidor function. All structure member values are supplied by the provider.

Syntax


typedef struct _PRINTPROVIDOR {
  BOOL   (*fpOpenPrinter)(
      PWSTR pPrinterName, 
      PHANDLE phPrinter, 
      PPRINTER_DEFAULTS pDefault);
  BOOL   (*fpSetJob)(
      HANDLE hPrinter, 
      DWORD JobId, 
      DWORD Level, 
      LPBYTE pJob, 
      DWORD Command);
  BOOL   (*fpGetJob)(
      HANDLE hPrinter, 
      DWORD JobId, 
      DWORD Level, 
      LPBYTE pJob, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpEnumJobs)(
      HANDLE hPrinter, 
      DWORD FirstJob, 
      DWORD NoJobs, 
      DWORD Level, 
      LPBYTE pJob, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  HANDLE (*fpAddPrinter)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE pPrinter);
  BOOL   (*fpDeletePrinter)(HANDLE hPrinter);
  BOOL   (*fpSetPrinter)(
      HANDLE hPrinter, 
      DWORD Level, 
      LPBYTE pPrinter, 
      DWORD Command);
  BOOL   (*fpGetPrinter)(
      HANDLE hPrinter, 
      DWORD Level, 
      LPBYTE pPrinter, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpEnumPrinters)(
      DWORD Flags, 
      LPWSTR Name, 
      DWORD Level, 
      LPBYTE pPrinterEnum, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpAddPrinterDriver)(
      LPWSTR Name, 
      DWORD Level, 
      LPBYTE pDriverInfo);
  BOOL   (*fpEnumPrinterDrivers)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      DWORD Level, 
      LPBYTE pDriverInfo, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpGetPrinterDriver)(
      HANDLE hPrinter, 
      LPWSTR pEnvironment, 
      DWORD Level, 
      LPBYTE pDriverInfo, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpGetPrinterDriverDirectory)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      DWORD Level, 
      LPBYTE pDriverDirectory, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpDeletePrinterDriver)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      LPWSTR pDriverName);
  BOOL   (*fpAddPrintProcessor)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      LPWSTR pPathName, 
      LPWSTR pPrintProcessorName);
  BOOL   (*fpEnumPrintProcessors)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      DWORD Level, 
      LPBYTE pPrintProcessorInfo, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpGetPrintProcessorDirectory)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      DWORD Level, 
      LPBYTE pPrintProcessorInfo, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpDeletePrintProcessor)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      LPWSTR pPrintProcessorName);
  BOOL   (*fpEnumPrintProcessorDatatypes)(
      LPWSTR pName, 
      LPWSTR pPrintProcessorName, 
      DWORD Level, 
      LPBYTE pDataypes, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  DWORD  (*fpStartDocPrinter)(
      HANDLE hPrinter, 
      DWORD Level, 
      LPBYTE pDocInfo);
  BOOL   (*fpStartPagePrinter)(HANDLE hPrinter);
  BOOL   (*fpWritePrinter)(
      HANDLE hPrinter, 
      LPVOID pBuf, 
      DWORD cbBuf, 
      LPDWORD pcWritten);
  BOOL   (*fpEndPagePrinter)(HANDLE hPrinter);
  BOOL   (*fpAbortPrinter)(HANDLE hPrinter);
  BOOL   (*fpReadPrinter)(
      HANDLE hPrinter, 
      LPVOID pBuf, 
      DWORD cbBuf, 
      LPDWORD pNoBytesRead);
  BOOL   (*fpEndDocPrinter)(HANDLE hPrinter);
  BOOL   (*fpAddJob)(
      HANDLE hPrinter, 
      DWORD Level, 
      LPBYTE pData, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpScheduleJob)(
      HANDLE hPrinter, 
      DWORD JobId);
  DWORD  (*fpGetPrinterData)(
      HANDLE hPrinter, 
      LPWSTR pValueName, 
      LPDWORD pType, 
      LPBYTE pData, 
      DWORD nSize, 
      LPDWORD pcbNeeded);
  DWORD  (*fpSetPrinterData)(
      HANDLE hPrinter, 
      LPWSTR pValueName, 
      DWORD Type, 
      LPBYTE pData, 
      DWORD cbData);
  DWORD  (*fpWaitForPrinterChange)(
      HANDLE hPrinter, 
      DWORD Flags);
  BOOL   (*fpClosePrinter)(HANDLE hPrinter);
  BOOL   (*fpAddForm)(
      HANDLE hPrinter, 
      DWORD Level, 
      LPBYTE pForm);
  BOOL   (*fpDeleteForm)(
      HANDLE hPrinter, 
      LPWSTR pFormName);
  BOOL   (*fpGetForm)(
      HANDLE hPrinter, 
      LPWSTR pFormName, 
      DWORD Level, 
      LPBYTE pForm, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded);
  BOOL   (*fpSetForm)(
      HANDLE hPrinter, 
      LPWSTR pFormName, 
      DWORD Level, 
      LPBYTE pForm);
  BOOL   (*fpEnumForms)(
      HANDLE hPrinter, 
      DWORD Level, 
      LPBYTE pForm, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpEnumMonitors)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE pMonitors, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpEnumPorts)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE pPorts, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpAddPort)(
      LPWSTR pName, 
      HWND hWnd, 
      LPWSTR pMonitorName);
  BOOL   (*fpConfigurePort)(
      LPWSTR pName, 
      HWND hWnd, 
      LPWSTR pPortName);
  BOOL   (*fpDeletePort)(
      LPWSTR pName, 
      HWND hWnd, 
      LPWSTR pPortName);
  HANDLE (*fpCreatePrinterIC)(
      HANDLE hPrinter, 
      LPDEVMODEW pDevMode);
  BOOL   (*fpPlayGdiScriptOnPrinterIC)(
      HANDLE hPrinterIC, 
      LPBYTE pIn, 
      DWORD cIn, 
      LPBYTE pOut, 
      DWORD cOut, 
      DWORD ul);
  BOOL   (*fpDeletePrinterIC)(HANDLE hPrinterIC);
  BOOL   (*fpAddPrinterConnection)(LPWSTR pName);
  BOOL   (*fpDeletePrinterConnection)(LPWSTR pName);
  DWORD  (*fpPrinterMessageBox)(
      HANDLE hPrinter, 
      DWORD Error, 
      HWND hWnd, 
      LPWSTR pText, 
      LPWSTR pCaption, 
      DWORD dwType);
  BOOL   (*fpAddMonitor)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE pMonitorInfo);
  BOOL   (*fpDeleteMonitor)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      LPWSTR pMonitorName);
  BOOL   (*fpResetPrinter)(
      HANDLE hPrinter, 
      LPPRINTER_DEFAULTS pDefault);
  BOOL   (*fpGetPrinterDriverEx)(
      HANDLE hPrinter, 
      LPWSTR pEnvironment, 
      DWORD Level, 
      LPBYTE pDriverInfo, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      DWORD dwClientMajorVersion, 
      DWORD dwClientMinorVersion, 
      PDWORD pdwServerMajorVersion, 
      PDWORD pdwServerMinorVersion);
  BOOL   (*fpFindFirstPrinterChangeNotification)(
      HANDLE hPrinter, 
      DWORD fdwFlags, 
      DWORD fdwOptions, 
      HANDLE hNotify, 
      PDWORD pfdwStatus, 
      PVOID pPrinterNotifyOptions, 
      PVOID pPrinterNotifyInit);
  BOOL   (*fpFindClosePrinterChangeNotification)(HANDLE hPrinter);
  BOOL   (*fpAddPortEx)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE lpBuffer, 
      LPWSTR lpMonitorName);
  BOOL   (*fpShutDown)(LPVOID pvReserved);
  BOOL   (*fpRefreshPrinterChangeNotification)(
      HANDLE hPrinter, 
      DWORD Reserved, 
      PVOID pvReserved, 
      PVOID pPrinterNotifyInfo);
  BOOL   (*fpOpenPrinterEx)(
      LPWSTR pPrinterName, 
      LPHANDLE phPrinter, 
      LPPRINTER_DEFAULTS pDefault, 
      LPBYTE pClientInfo, 
      DWORD Level);
  HANDLE (*fpAddPrinterEx)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE pPrinter, 
      LPBYTE pClientInfo, 
      DWORD ClientInfoLevel);
  BOOL   (*fpSetPort)(
      LPWSTR pName, 
      LPWSTR pPortName, 
      DWORD Level, 
      LPBYTE pPortInfo);
  DWORD  (*fpEnumPrinterData)(
      HANDLE hPrinter, 
      DWORD dwIndex, 
      LPWSTR pValueName, 
      DWORD cbValueName, 
      LPDWORD pcbValueName, 
      LPDWORD pType, 
      LPBYTE pData, 
      DWORD cbData, 
      LPDWORD pcbData);
  DWORD  (*fpDeletePrinterData)(
      HANDLE hPrinter, 
      LPWSTR pValueName);
  DWORD  (*fpClusterSplOpen)(
      LPCTSTR pszServer, 
      LPCTSTR pszResource, 
      PHANDLE phSpooler, 
      LPCTSTR pszName, 
      LPCTSTR pszAddress);
  DWORD  (*fpClusterSplClose)(HANDLE hSpooler);
  DWORD  (*fpClusterSplIsAlive)(HANDLE hSpooler);
  DWORD  (*fpSetPrinterDataEx)(
      HANDLE hPrinter, 
      LPCWSTR pKeyName, 
      LPCWSTR pValueName, 
      DWORD Type, 
      LPBYTE pData, 
      DWORD cbData);
  DWORD  (*fpGetPrinterDataEx)(
      HANDLE hPrinter, 
      LPCWSTR pKeyName, 
      LPCWSTR pValueName, 
      LPDWORD pType, 
      LPBYTE pData, 
      DWORD nSize, 
      LPDWORD pcbNeeded);
  DWORD  (*fpEnumPrinterDataEx)(
      HANDLE hPrinter, 
      LPCWSTR pKeyName, 
      LPBYTE pEnumValues, 
      DWORD cbEnumValues, 
      LPDWORD pcbEnumValues, 
      LPDWORD pnEnumValues);
  DWORD  (*fpEnumPrinterKey)(
      HANDLE hPrinter, 
      LPCWSTR pKeyName, 
      LPWSTR pSubkey, 
      DWORD cbSubkey, 
      LPDWORD pcbSubkey);
  DWORD  (*fpDeletePrinterDataEx)(
      HANDLE hPrinter, 
      LPCWSTR pKeyName, 
      LPCWSTR pValueName);
  DWORD  (*fpDeletePrinterKey)(
      HANDLE hPrinter, 
      LPCWSTR pKeyName);
  BOOL   (*fpSeekPrinter)(
      HANDLE hPrinter, 
      LARGE_INTEGER liDistanceToMove, 
      PLARGE_INTEGER pliNewPointer, 
      DWORD dwMoveMethod, 
      BOOL bWrite);
  BOOL   (*fpDeletePrinterDriverEx)(
      LPWSTR pName, 
      LPWSTR pEnvironment, 
      LPWSTR pDriverName, 
      DWORD dwDeleteFlag, 
      DWORD dwVersionNum);
  BOOL   (*fpAddPerMachineConnection)(
      LPCWSTR pServer, 
      LPCWSTR pPrinterName, 
      LPCWSTR pPrintServer, 
      LPCWSTR pProvider);
  void   (*fpDeletePerMachineConnection)(
      LPCWSTR pServer, 
      LPCWSTR pPrinterName);
  BOOL   (*fpEnumPerMachineConnections)(
      LPCWSTR pServer, 
      LPBYTE pPrinterEnum, 
      DWORD cbBuf, 
      LPDWORD pcbNeeded, 
      LPDWORD pcReturned);
  BOOL   (*fpXcvData)(
      HANDLE hXcv, 
      LPCWSTR pszDataName, 
      PBYTE pInputData, 
      DWORD cbInputData, 
      PBYTE pOutputData, 
      DWORD cbOutputData, 
      PDWORD pcbOutputNeeded, 
      PDWORD pdwStatus);
  BOOL   (*fpAddPrinterDriverEx)(
      LPWSTR pName, 
      DWORD Level, 
      LPBYTE pDriverInfo, 
      DWORD dwFileCopyFlags);
  BOOL   (*fpSplReadPrinter)(
      HANDLE hPrinter, 
      LPBYTE* pBuf, 
      DWORD cbBuf);
  BOOL   (*fpDriverUnloadComplete)(LPWSTR pDriverFile);
  BOOL   (*fpGetSpoolFileInfo)(
      HANDLE hPrinter, 
      LPWSTR* pSpoolDir, 
      LPHANDLE phFile, 
      HANDLE hSpoolerProcess, 
      HANDLE hAppProcess);
  BOOL   (*fpCommitSpoolData)(
      HANDLE hPrinter, 
      DWORD cbCommit);
  BOOL   (*fpCloseSpoolFileHandle)(HANDLE hPrinter);
  BOOL   (*fpFlushPrinter)(
      HANDLE hPrinter, 
      LPBYTE pBuf, 
      DWORD cbBuf, 
      LPDWORD pcWritten, 
      DWORD cSleep);
  DWORD  (*fpSendRecvBidiData)(
      HANDLE hPrinter, 
      LPCWSTR pAction, 
      PBIDI_REQUEST_CONTAINER pReqData, 
      PBIDI_RESPONSE_CONTAINER* ppResData);
} PRINTPROVIDOR, *LPPRINTPROVIDOR;

Members

fpOpenPrinter

(Required.) Pointer to the provider's OpenPrinter function, which is described in the Microsoft Windows SDK documentation. However, at the provider level, this function must supply one of the DWORD return values listed in the following table.

Return valueDefinition
ROUTER_SUCCESSThe provider supports the specified printer and has opened it.
ROUTER_STOP_ROUTINGThe provider supports the specified printer, but an error occurred and the printer could not be opened. It is assumed that no other provider can support the printer. The function must call SetLastError.
ROUTER_UNKNOWN The provider does not support the specified printer. The function must call SetLastError and specify ERROR_INVALID_NAME.

 

The router calls each provider until one of them returns ROUTER_SUCCESS or ROUTER_STOP_ROUTING. If the provider returns ROUTER_SUCCESS, it must also return a unique handle. (For more information, see Introduction to Print Providers.) The router first attempts to call the provider's OpenPrinterEx function. If that function is not supported, the router calls OpenPrinter.

fpSetJob

(Required.) Pointer to the provider's SetJob function (described in the Windows SDK documentation).

fpGetJob

(Required.) Pointer to the provider's GetJob function (described in the Windows SDK documentation).

fpEnumJobs

(Required.) Pointer to the provider's EnumJobs function (described in the Windows SDK documentation).

fpAddPrinter

(Optional. Can be NULL.) Pointer to the provider's AddPrinter function (described in the Windows SDK documentation).

fpDeletePrinter

(Optional. Can be NULL.) Pointer to the provider's DeletePrinter function (described in the Windows SDK documentation).

fpSetPrinter

(Required.) Pointer to the provider's SetPrinter function (described in the Windows SDK documentation).

fpGetPrinter

(Required.) Pointer to the provider's GetPrinter function (described in the Windows SDK documentation). If you are writing a network print provider and GetPrinter is returning a PRINTER_INFO_2 structure, the function should supply only the cJobs and Status structure members. The local print provider supplies the rest of the structure members.

fpEnumPrinters

(Required.) Pointer to the provider's EnumPrinters function (described in the Windows SDK documentation).

fpAddPrinterDriver

(Optional. Can be NULL.) Pointer to the provider's AddPrinterDriver function (described in the Windows SDK documentation). If the provider does not support the specified driver or server, it should specify ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpEnumPrinterDrivers

(Optional. Can be NULL.) Pointer to the provider's EnumPrinterDrivers function (described in the Windows SDK documentation). If the provider does not support the specified server, it should specify ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpGetPrinterDriver

(Optional. Can be NULL.) Pointer to the provider's GetPrinterDriver function (described in the Windows SDK documentation). The router first attempts to call the provider's GetPrinterDriverEx function. If that function is not supported, the router calls GetPrinterDriver.

fpGetPrinterDriverDirectory

(Optional. Can be NULL.) Pointer to the provider's GetPrinterDriverDirectory function (described in the Windows SDK documentation). If the provider does not support the specified server, it should specify ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpDeletePrinterDriver

(Optional. Can be NULL.) Pointer to the provider's DeletePrinterDriver function (described in the Windows SDK documentation). If the provider does not support the specified server, it should specify ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpAddPrintProcessor

(Optional. Can be NULL.) Pointer to the provider's AddPrintProcessor function (described in the Windows SDK documentation).

fpEnumPrintProcessors

(Optional. Can be NULL.) Pointer to the provider's EnumPrintProcessors function (described in the Windows SDK documentation).

fpGetPrintProcessorDirectory

(Optional. Can be NULL.) Pointer to the provider's GetPrintProcessorDirectory function (described in the Windows SDK documentation).

fpDeletePrintProcessor

(Optional. Can be NULL.) Pointer to the provider's DeletePrintProcessor function (described in the Windows SDK documentation).

fpEnumPrintProcessorDatatypes

(Optional. Can be NULL.) Pointer to the provider's EnumPrintProcessorDatatypes function (described in the Windows SDK documentation).

fpStartDocPrinter

(Required.) Pointer to the provider's StartDocPrinter function (described in the Windows SDK documentation).

fpStartPagePrinter

(Optional. Can be NULL.) Pointer to the provider's StartPagePrinter function (described in the Windows SDK documentation).

fpWritePrinter

(Required.) Pointer to the provider's WritePrinter function (described in the Windows SDK documentation).

fpEndPagePrinter

(Optional. Can be NULL.) Pointer to the provider's EndPagePrinter function (described in the Windows SDK documentation).

fpAbortPrinter

(Required.) Pointer to the provider's AbortPrinter function (described in the Windows SDK documentation).

fpReadPrinter

(Optional. Can be NULL.) Pointer to the provider's ReadPrinter function (described in the Windows SDK documentation).

fpEndDocPrinter

(Required.) Pointer to the provider's EndDocPrinter function (described in the Windows SDK documentation).

fpAddJob

(Required.) Pointer to the provider's AddJob function (described in the Windows SDK documentation).

fpScheduleJob

(Required.) Pointer to the provider's ScheduleJob function (described in the Windows SDK documentation).

fpGetPrinterData

(Optional. Can be NULL.) Pointer to the provider's GetPrinterData function (described in the Windows SDK documentation).

fpSetPrinterData

(Optional. Can be NULL.) Pointer to the provider's SetPrinterData function (described in the Windows SDK documentation).

fpWaitForPrinterChange

Obsolete. Must be NULL.

fpClosePrinter

(Required.) Pointer to the provider's ClosePrinter function (described in the Windows SDK documentation). If a printer change notification object has been created, then the router calls the provider's FindClosePrinterChangeNotification function (described in the Windows SDK documentation) before calling ClosePrinter.

fpAddForm

(Optional. Can be NULL.) Pointer to the provider's AddForm function (described in the Windows SDK documentation).

fpDeleteForm

(Optional. Can be NULL.) Pointer to the provider's DeleteForm function (described in the Windows SDK documentation).

fpGetForm

(Optional. Can be NULL.) Pointer to the provider's GetForm function (described in the Windows SDK documentation).

fpSetForm

(Optional. Can be NULL.) Pointer to the provider's SetForm function (described in the Windows SDK documentation).

fpEnumForms

(Optional. Can be NULL.) Pointer to the provider's EnumForms function (described in the Windows SDK documentation).

fpEnumMonitors

(Optional. Can be NULL.) Pointer to the provider's EnumMonitors function, which is described in the Windows SDK documentation. However, at the provider level this function must supply one of the DWORD return values listed in the following table.

Return valueDefinition
ROUTER_SUCCESSThe provider has enumerated the monitors on the specified server.
ROUTER_STOP_ROUTINGThe provider has enumerated the monitors on the specified server, and the router should not call other providers.
ROUTER_UNKNOWN The provider does not support the specified server.

 

fpEnumPorts
Return valueDefinition
ROUTER_SUCCESSThe provider has enumerated the ports on the specified server.
ROUTER_STOP_ROUTINGThe provider has enumerated the ports on the specified server, and the router should not call other providers.
ROUTER_UNKNOWN The provider does not support the specified server.

 

fpAddPort

(Optional. Can be NULL.) Pointer to the provider's AddPort function (described in the Windows SDK documentation). If the provider does not support the specified port, it must supply ERROR_NOT_SUPPORTED to SetLastError before returning FALSE.

fpConfigurePort

(Required.) Pointer to the provider's ConfigurePort function (described in the Windows SDK documentation). If the function supplies ERROR_NOT_SUPPORTED, ERROR_INVALID_NAME, or ERROR_UNKNOWN_PORT to SetLastError, the router will attempt to call another provider.

fpDeletePort

(Required.) Pointer to the provider's DeletePort function (described in the Windows SDK documentation). If the provider does not support the specified port, it must supply ERROR_NOT_SUPPORTED to SetLastError before returning FALSE.

fpCreatePrinterIC

For internal use only. Must be NULL.

fpPlayGdiScriptOnPrinterIC

For internal use only. Must be NULL.

fpDeletePrinterIC

For internal use only. Must be NULL.

fpAddPrinterConnection

(Optional. Can be NULL.) Pointer to the provider's AddPrinterConnection function (described in the Windows SDK documentation).

fpDeletePrinterConnection

(Optional. Can be NULL.) Pointer to the provider's DeletePrinterConnection function (described in the Windows SDK documentation).

fpPrinterMessageBox

Not used. Must be NULL.

fpAddMonitor

(Optional. Can be NULL.) Pointer to the provider's AddMonitor function (described in the Windows SDK documentation). If the provider does not support the specified monitor, it must supply ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpDeleteMonitor

(Optional. Can be NULL.) Pointer to the provider's DeleteMonitor function (described in the Windows SDK documentation). If the provider does not support the specified monitor, it must supply ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpResetPrinter

(Optional. Can be NULL.) Pointer to the provider's ResetPrinter function (described in the Windows SDK documentation).

fpGetPrinterDriverEx

(Optional. Can be NULL.) Pointer to the provider's GetPrinterDriverEx function (described in the Windows SDK documentation). If GetPrinterDriverEx is not supported, the router attempts to call GetPrinterDriver.

fpFindFirstPrinterChangeNotification

(Optional. Can be NULL.) Pointer to the provider's FindFirstPrinterChangeNotification function (described in the Windows SDK documentation).

fpFindClosePrinterChangeNotification

(Optional. Can be NULL.) Pointer to the provider's FindClosePrinterChangeNotification function (described in the Windows SDK documentation).

fpAddPortEx

(Optional. Can be NULL.) Pointer to the provider's AddPortEx function (described in the Windows SDK documentation). If the provider does not support the specified port, it must supply ERROR_NOT_SUPPORTED to SetLastError before returning FALSE.

fpShutDown

For internal use only. Must be NULL.

fpRefreshPrinterChangeNotification

(Optional. Can be NULL.) Pointer to the provider's RefreshPrinterChangeNotification function.

fpOpenPrinterEx

For internal use only. Must be NULL.

fpAddPrinterEx

For internal use only. Must be NULL.

fpSetPort

(Optional. Can be NULL.) Pointer to the provider's SetPort function (described in the Windows SDK documentation). If the function supplies ERROR_NOT_SUPPORTED, ERROR_INVALID_NAME, or ERROR_UNKNOWN_PORT to SetLastError, the router will attempt to call another provider.

fpEnumPrinterData

(Optional. Can be NULL.) Pointer to the provider's EnumPrinterData function (described in the Windows SDK documentation).

fpDeletePrinterData

(Optional. Can be NULL.) Pointer to the provider's DeletePrinterData function (described in the Windows SDK documentation).

fpClusterSplOpen

For internal use only. Must be NULL.

fpClusterSplClose

For internal use only. Must be NULL.

fpClusterSplIsAlive

For internal use only. Must be NULL.

fpSetPrinterDataEx

(Optional. Can be NULL.) Pointer to the provider's SetPrinterDataEx function (described in the Windows SDK documentation).

fpGetPrinterDataEx

(Optional. Can be NULL.) Pointer to the provider's GetPrinterDataEx function (described in the Windows SDK documentation).

fpEnumPrinterDataEx

(Optional. Can be NULL.) Pointer to the provider's EnumPrinterDataEx function (described in the Windows SDK documentation).

fpEnumPrinterKey

(Optional. Can be NULL.) Pointer to the provider's EnumPrinterKey function (described in the Windows SDK documentation).

fpDeletePrinterDataEx

(Optional. Can be NULL.) Pointer to the provider's DeletePrinterDataEx function (described in the Windows SDK documentation).

fpDeletePrinterKey

(Optional. Can be NULL.) Pointer to the provider's DeletePrinterKey function (described in the Windows SDK documentation).

fpSeekPrinter

For internal use only. Must be NULL.

fpDeletePrinterDriverEx

(Optional. Can be NULL.) Pointer to the provider's DeletePrinterDriverEx function (described in the Windows SDK documentation). If the provider does not support the specified server, it should specify ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpAddPerMachineConnection

For internal use only. Must be NULL.

fpDeletePerMachineConnection

For internal use only. Must be NULL.

fpEnumPerMachineConnections

For internal use only. Must be NULL.

fpXcvData

(Optional. Can be NULL.) Pointer to the provider's XcvData function.

fpAddPrinterDriverEx

(Optional. Can be NULL.) Pointer to the provider's AddPrinterDriverEx function (described in the Windows SDK documentation). If the provider does not support the specified server, it should specify ERROR_INVALID_NAME to SetLastError before returning FALSE.

fpSplReadPrinter

For internal use only. Must be NULL.

fpDriverUnloadComplete

For internal use only. Must be NULL.

fpGetSpoolFileInfo

For internal use only. Must be NULL.

fpCommitSpoolData

For internal use only. Must be NULL.

fpCloseSpoolFileHandle

For internal use only. Must be NULL.

fpFlushPrinter

For internal use only. Must be NULL.

fpSendRecvBidiData

(Optional. Can be NULL.) Pointer to the provider's SendRecvBidiData function. If this parameter is NULL, it means that the provider does not support bidi communication.

Remarks

Function pointers are listed in the order they are specified within the PRINTPROVIDOR structure. To see function descriptions grouped by related capabilities, see Functions Defined by Print Providers.

Requirements

Header

Winsplp.h (include Winsplp.h)

See also

InitializePrintProvidor
FindFirstPrinterChangeNotification
RefreshPrinterChangeNotification
XcvData
SendRecvBidiData

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.