MergeAndValidatePrintTicketThunk2-Funktion
[Diese Funktion wird nicht unterstützt und kann in zukünftigen Versionen von Windows deaktiviert oder gelöscht werden. PTMergeAndValidatePrintTicket bietet gleichwertige Funktionen und sollte stattdessen verwendet werden.]
Führt zwei Drucktickets zusammen und gibt ein gültiges, praktikables Druckticket zurück.
Syntax
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
);
Parameter
-
hProvider [in]
-
Ein Handle für einen offenen Druckticketanbieter. Dieses Handle wird von der BindPTProviderThunk-Funktion zurückgegeben.
-
pBasePrintTicket [in]
-
Der Puffer, der die Basisdaten des Drucktickets enthält, ausgedrückt in XML, wie im Druckschema beschrieben.
-
basePrintTicketLength [in]
-
Die Größe des Puffers, auf den von pBasePrintTicket verwiesen wird, in Bytes.
-
pDeltaPrintTicket [in, optional]
-
Der Puffer, der das zusammenzuführende Druckticket enthält. Die Druckticketdaten werden in XML ausgedrückt, wie im Druckschema beschrieben. Der Wert dieses Parameters kann NULL sein.
-
deltaPrintTicketLength [in]
-
Die Größe des Puffers, auf den pDeltaPrintTicket verweist, in Bytes.
-
Bereich [in]
-
Der Wert, der angibt, ob der Bereich von pDeltaPrintTicket und ppValidatedPrintTicket eine einzelne Seite, ein gesamtes Dokument oder alle Dokumente im Druckauftrag ist. Der Wert dieses Parameters muss ein Member der EPrintTicketScope-Enumeration sein, der als DWORD umgewandelt wird.
-
ppValidatedPrintTicket [out]
-
Die Adresse des Puffers, der das zusammengeführte und überprüfte Druckticket enthält. Diese Funktion ruft CoTaskMemAlloc auf, um diesen Puffer zuzuweisen. Wenn der Puffer nicht mehr benötigt wird, muss der Aufrufer ihn durch Aufrufen von CoTaskMemFree freigeben.
-
pValidatedPrintTicketLength [out]
-
Die Größe des Puffers, auf den ppValidatedPrintTicket verweist, in Bytes.
-
pbstrErrorMessage [out, optional]
-
Ein Zeiger auf eine Zeichenfolge, die angibt, was, falls überhaupt, am Druckticket in pBasePrintTicket oder pDeltaPrintTicket ungültig ist. Wenn beide gültig sind, ist dieser Wert NULL. Wenn pbstrErrorMessage nicht NULL ist, wenn die Funktion zurückgibt, muss der Aufrufer die Zeichenfolge mit SysFreeString freigeben.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|