MergeAndValidatePrintTicketThunk2 fonction)

[Cette fonction n’est pas prise en charge et peut être désactivée ou supprimée dans les versions ultérieures de Windows. PTMergeAndValidatePrintTicket fournit des fonctionnalités équivalentes et doit être utilisé à la place.]

Fusionne deux tickets d’impression et retourne un ticket d’impression valide et viable.

Syntaxe

HRESULT MergeAndValidatePrintTicketThunk2(
  _In_      HPTPROVIDER hProvider,
  _In_      BYTE        *pBasePrintTicket,
  _In_      INT         basePrintTicketLength,
  _In_opt_  BYTE        *pDeltaPrintTicket,
  _In_      INT         deltaPrintTicketLength,
  _In_      DWORD       scope,
  _Out_     BYTE        **ppValidatedPrintTicket,
  _Out_     INT         *pValidatedPrintTicketLength,
  _Out_opt_ BSTR        *pbstrErrorMessage
);

Paramètres

hProvider [ dans]

Handle d’un fournisseur de tickets d’impression ouvert. Ce descripteur est retourné par la fonction BindPTProviderThunk .

pBasePrintTicket [ dans]

Mémoire tampon qui contient les données de ticket d’impression de base, exprimées en XML, comme décrit dans le schéma d’impression.

basePrintTicketLength [ dans]

Taille, en octets, de la mémoire tampon référencée par pBasePrintTicket.

pDeltaPrintTicket [ dans, facultatif]

Mémoire tampon qui contient le ticket d’impression à fusionner. Les données du ticket d’impression sont exprimées en XML, comme décrit dans le schéma d’impression. La valeur de ce paramètre peut être null.

deltaPrintTicketLength [ dans]

Taille, en octets, de la mémoire tampon référencée par pDeltaPrintTicket.

étendue [ dans]

Valeur qui spécifie si l’étendue de pDeltaPrintTicket et ppValidatedPrintTicket est une page unique, un document entier ou tous les documents du travail d’impression. La valeur de ce paramètre doit être un membre de l’énumération EPrintTicketScope , castée en tant que valeur DWORD.

ppValidatedPrintTicket [ à]

Adresse de la mémoire tampon qui contient les tickets d’impression fusionnés et validés. Cette fonction appelle CoTaskMemAlloc pour allouer cette mémoire tampon. Lorsque la mémoire tampon n’est plus nécessaire, l’appelant doit la libérer en appelant CoTaskMemFree.

pValidatedPrintTicketLength [ à]

Taille, en octets, de la mémoire tampon référencée par ppValidatedPrintTicket.

pbstrErrorMessage [ out, facultatif]

Pointeur vers une chaîne qui spécifie ce qui, le cas échéant, n’est pas valide concernant le ticket d’impression dans pBasePrintTicket ou pDeltaPrintTicket. Si elles sont toutes deux valides, cette valeur est null. Si pbstrErrorMessage n’a pas la valeur null lorsque la fonction retourne, l’appelant doit libérer la chaîne avec SysFreeString.

Valeur retournée

Si la méthode est réussie, elle retourne S _ OK; sinon, elle retourne un code d’erreur HRESULT . Pour plus d’informations sur les codes d’erreur COM, consultez gestion des erreurs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
DLL
Prntvpt.dll

Voir aussi

Schéma d’impression

PTMergeAndValidatePrintTicket

Impression

Fonctions API du spouleur d’impression