InitializePrintProvidor function (winsplp.h)

Warning

Starting with Windows 10, the APIs which support third-party print providers are deprecated. Microsoft does not recommend any investment into third-party print providers. Additionally, on Windows 8 and newer products where the v4 print driver model is available, third-party print providers may not create or manage queues which use v4 print drivers.

A print provider's InitializePrintProvidor function initializes the provider and supplies the print spooler with the provider's entry points.

Syntax

BOOL InitializePrintProvidor(
  [out]          LPPRINTPROVIDOR pPrintProvidor,
  [in]           DWORD           cbPrintProvidor,
  [in, optional] LPWSTR          pFullRegistryPath
);

Parameters

[out] pPrintProvidor

Caller-supplied address of a PRINTPROVIDOR structure, to be filled in by the print provider.

[in] cbPrintProvidor

Caller-supplied size, in bytes, of the PRINTPROVIDOR structure pointed to by pPrintProvidor.

[in, optional] pFullRegistryPath

Caller-supplied pointer to a string representing the full registry path to the provider's registry entry.

Return value

If the operation succeeds, the function should return TRUE. Otherwise the function should return FALSE.

Remarks

Print providers are required to define an InitializePrintProvidor function, which is the first function called by the spooler after the provider has been loaded. The function must fill the supplied PRINTPROVIDOR structure with pointers to the provider's defined functions (see Functions defined by print providers). The function can also perform other provider-specific initialization operations.

Requirements

Requirement Value
Target Platform Desktop
Header winsplp.h (include Winsplp.h)

See also

PRINTPROVIDOR