PTOpenProviderEx, fonction (prntvpt.h)

Article
03/01/2024

Ouvre une instance d’un fournisseur de tickets d’impression.

Syntaxe

HRESULT PTOpenProviderEx(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwMaxVersion,
        DWORD       dwPrefVersion,
  [out] HPTPROVIDER *phProvider,
  [out] DWORD       *pUsedVersion
);

Paramètres

[in] pszPrinterName

Pointeur vers le nom complet d’une file d’attente d’impression.

dwMaxVersion

Dernière version du schéma d’impression pris en charge par l’appelant.

dwPrefVersion

Version du schéma d’impression demandé par l’appelant.

[out] phProvider

Pointeur vers un handle pour le fournisseur.

[out] pUsedVersion

Pointeur vers la version du schéma d’impression que le fournisseur de ticket d’impression utilisera.

Valeur retournée

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

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

Remarques

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.

Le paramètre pszPrinterName doit être le nom complet, et non le nom tronqué tel qu’il peut apparaître dans un DEVMODE.

La première version du schéma d’impression a été publiée avec Windows Vista et est la version 1. Si le fournisseur de tickets d’impression ne prend pas en charge prefVersion, PTOpenProviderEx ouvre correctement un handle et retourne une version antérieure dans usedVersion.

Pour éviter une fuite de ressources, phProvider doit être fermé avec PTCloseProvider.

Configuration requise

Condition requise	Valeur
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

Schéma d’impression

Fonctions API du spouleur d’impression

Impression

Share via