Partager via


Fonction OpenPrintProcessor (winsplp.h)

La fonction d’un OpenPrintProcessor processeur d’impression prépare le processeur d’impression pour l’impression d’un travail et retourne un handle.

Syntaxe

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Paramètres

[in] pPrinterName

Pointeur fourni par l’appelant vers le nom de l’imprimante pour laquelle le processeur d’impression est ouvert.

[in] pPrintProcessorOpenData

Pointeur fourni par l’appelant vers une structure PRINTPROCESSOROPENDATA .

Valeur retournée

Si l’opération réussit, la fonction doit retourner un handle qui peut être utilisé comme argument d’entrée pour les appels suivants à PrintDocumentOnPrintProcessor, ControlPrintProcessor et ClosePrintProcessor. Si l’opération échoue, la fonction doit appeler SetLastError pour définir un code d’erreur, puis retourner null.

Remarques

Les processeurs d’impression sont nécessaires pour exporter une OpenPrintProcessor fonction. Le spouleur appelle la fonction lorsqu’un travail d’impression est disponible. La fonction doit effectuer des opérations d’initialisation qui sont requises avant qu’un travail puisse être traité, en fonction du type de données du travail.

La fonction doit retourner un handle. En règle générale, le handle est un pointeur vers une structure interne. La structure doit contenir un pointeur vers le nom de l’imprimante et un pointeur vers la structure DEVMODEW de l’imprimante, qui sont tous deux reçus dans la structure PRINTPROCESSOROPENDATA . Ces deux pointeurs sont requis par la fonction PrintDocumentOnPrintProcessor du processeur d’impression, et cette dernière fonction reçoit le handle en tant qu’entrée lorsque le spouleur l’appelle.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête winsplp.h (inclure Winsplp.h)
Bibliothèque Nwprint.lib

Voir aussi

ClosePrintProcessor

ControlPrintProcessor

PRINTPROCESSOROPENDATA

PrintDocumentOnPrintProcessor