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
Prntvpt.dll

Weitere Informationen

Druckschema

PTConvertPrintTicketToDevMode

Drucken

Druckspooler-API-Funktionen