PTConvertDevModeToPrintTicket, fonction (prntvpt.h)

Article
08/25/2023

Convertit une structure DEVMODE en ticket d’impression à l’intérieur d’un IStream.

Syntaxe

HRESULT PTConvertDevModeToPrintTicket(
  [in] HPTPROVIDER       hProvider,
       ULONG             cbDevmode,
  [in] PDEVMODE          pDevmode,
  [in] EPrintTicketScope scope,
       IStream           *pPrintTicket
);

Paramètres

[in] hProvider

Handle pour un fournisseur de tickets d’impression ouvert. Ce handle est retourné par la fonction PTOpenProvider ou PTOpenProviderEx .

cbDevmode

Taille du DEVMODE en octets.

[in] pDevmode

Pointeur vers le DEVMODE.

[in] scope

Valeur qui spécifie l’étendue de pPrintTicket. Cette valeur peut spécifier une page unique, un document entier ou tous les documents du travail d’impression. Les paramètres de pDevmode qui se trouvent en dehors de l’étendue spécifiée ne seront pas inclus dans pPrintTicket. Consultez la section Notes.

pPrintTicket

Pointeur vers un IStream avec sa position de recherche au début du ticket d’impression.

Valeur retournée

Si l’opération réussit, la valeur de retour est S_OK, sinon le HRESULT contient un code d’erreur.

Si hProvider a été ouvert dans un thread différent, hrESULT est E_INVALIDARG.

Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.

Notes

Note Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et l’implémentation du pilote d’imprimante, facteurs difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.

hProvider doit être un handle qui a été ouvert dans le même thread que le thread dans lequel il est utilisé pour cette fonction.

Si le pDevmode pointe vers une autre imprimante, ses paramètres peuvent être perdus et remplacés par les valeurs par défaut.

Les paramètres de pDevmode qui sont en dehors de l’étendue ne sont pas inclus dans pPrintTicket. Par exemple, si l’étendue est une seule page, les paramètres à l’échelle du travail et les paramètres à l’échelle du document ne sont pas inclus. Une étendue de travail inclut l’étendue du document et l’étendue de la page. Une étendue de document inclut l’étendue de page.

PTConvertDevModeToPrintTicket écrit le ticket d’impression dans l’IStream référencé par pPrintTicket en commençant au point de recherche actuel du flux. Une fois que PTConvertDevModeToPrintTicket est retourné, l’appelant doit réinitialiser le point de recherche au point de recherche initial pour lire le ticket d’impression retourné par la fonction.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	prntvpt.h
Bibliothèque	Prntvpt.lib
DLL	Prntvpt.dll

Voir aussi

Imprimer le schéma

Fonctions API du spouleur d’impression

Impression

Partager via