Fonction MergeAndValidatePrintTicketThunk2
[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 [in]
-
Handle pour un fournisseur de ticket d’impression ouvert. Ce handle est retourné par la fonction BindPTProviderThunk .
-
pBasePrintTicket [in]
-
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 [in]
-
Taille, en octets, de la mémoire tampon référencée par pBasePrintTicket.
-
pDeltaPrintTicket [in, facultatif]
-
Mémoire tampon qui contient le ticket d’impression à fusionner. Les données de 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 [in]
-
Taille, en octets, de la mémoire tampon référencée par pDeltaPrintTicket.
-
scope [in]
-
Valeur qui spécifie si l’étendue de pDeltaPrintTicket et ppValidatedPrintTicket est une seule page, un document entier ou tous les documents du travail d’impression. La valeur de ce paramètre doit être membre de l’énumération EPrintTicketScope , cast en tant que DWORD.
-
ppValidatedPrintTicket [out]
-
Adresse de la mémoire tampon qui contient le ticket d’impression fusionné et validé. 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 [out]
-
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 pour le ticket d’impression dans pBasePrintTicket ou pDeltaPrintTicket. S’ils sont tous les deux valides, cette valeur est NULL. Si pbstrErrorMessage n’est pas NULL lorsque la fonction est retournée, l’appelant doit libérer la chaîne avec SysFreeString.
Valeur retournée
Si la méthode réussit, elle retourne S_OK ; sinon, il retourne un code d’erreur HRESULT . Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.
Spécifications
| 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] |
| DLL |
|