PTOpenProvider, fonction (prntvpt.h)

Article
03/04/2024

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

Syntaxe

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

Paramètres

[in] pszPrinterName

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

dwVersion

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

[out] phProvider

Pointeur vers un handle pour le fournisseur.

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.

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. Cette opération échoue si la version n’est pas prise en charge. Comparez cela avec PTOpenProviderEx qui ouvre un fournisseur même s’il prend en charge uniquement les versions antérieures à celles demandées.

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

Imprimer le schéma

Fonctions API du spouleur d’impression

Impression

Partager via