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 AUSGABE DEVMODE bereitzustellen, wenn pPrintTicket nicht alle möglichen Einstellungen für eine DEVMODE-Datei angibt. Der Wert dieses Parameters muss ein Member der EDefaultDevmodeType-Enumeration sein, die als INT umgewandelt 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 und als DWORD umgewandelt werden.
-
ppDevmode [out]
-
Die Adresse des neu erstellten DEVMODE. 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.
-
pcbDevModeLength [out]
-
Die Größe des DEVMODE in Bytes, die in ppDevmode zurückgegeben wird.
-
errMsg [out, optional]
-
Ein Zeiger auf eine Zeichenfolge, die angibt, was, falls ü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 SysFreeString freigeben.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. 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 |
|