ConvertPrintTicketToDevModeThunk2-Funktion
[Diese Funktion wird nicht unterstützt und kann in zukünftigen Versionen von Windows deaktiviert oder gelöscht werden. PTConvertPrintTicketToDevMode bietet entsprechende Funktionen und sollte stattdessen verwendet werden.]
Konvertiert ein Druckticket in eine DEVMODE-Struktur.
Syntax
HRESULT ConvertPrintTicketToDevModeThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ ULONG cbSize,
_In_ INT baseType,
_In_ DWORD scope,
_Out_ BYTE **ppDevmode,
_Out_ ULONG *pcbDevModeLength,
_Out_opt_ BSTR *errMsg
);
Parameter
-
hProvider [ In]
-
Ein Handle für einen offenen Druckticketanbieter. Dieses Handle wird von der BindPTProviderThunk-Funktion zurückgegeben.
-
pPrintTicket [ In]
-
Der Puffer, der das zu konvertierende Druckticket enthält.
-
cbSize [ In]
-
Die Größe des in pPrintTicket übergebenen Puffers in Bytes.
-
baseType [ In]
-
Ein -Wert, der angibt, ob der DEVMODE-Standard des Benutzers oder der DEVMODE-Standard der Druckwarteschlange verwendet wird, um Werte für die DEVMODE-Ausgabe bereitzustellen, wenn pPrintTicket nicht jede mögliche Einstellung für einen DEVMODE angibt. Der Wert dieses Parameters muss ein Member der EDefaultDevmodeType-Enumeration sein, der als INT-Typ definiert wird.
-
Bereich [ In]
-
Ein -Wert, der den Bereich von pPrintTicket angibt. Dieser Wert kann eine einzelne Seite, ein gesamtes Dokument oder alle Dokumente im Druckauftrag angeben. Der Wert dieses Parameters muss ein Member der EPrintTicketScope-Enumeration sein, der in ein DWORD-Element umformt wird.
-
ppDevmode [ out]
-
Die Adresse des neu erstellten DEVMODE. Diese Funktion ruft CoTaskMemAlloc auf, um diesen Puffer zuzuordnen. Wenn der Puffer nicht mehr benötigt wird, muss der Aufrufer ihn durch Aufrufen von CoTaskMemFreefreigeben.
-
pwDevModeLength [ out]
-
Die Größe des in ppDevmode zurückgegebenen DEVMODE in Bytes.
-
errMsg [ out, optional]
-
Ein Zeiger auf eine Zeichenfolge, die angibt, was , wenn überhaupt, für das Druckticket in pPrintTicket ungültig ist. Wenn sie gültig ist, ist dies NULL. Wenn errMsg nicht NULL ist, wenn die Funktion zurückgegeben wird, muss der Aufrufer die Zeichenfolge mit SysFreeStringfreigeben.
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.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|