GetPrintCapabilitiesThunk2-Funktion

[Diese Funktion wird nicht unterstützt und kann in zukünftigen Versionen von Windows deaktiviert oder gelöscht werden. PTGetPrintCapabilities bietet entsprechende Funktionen und sollte stattdessen verwendet werden.]

Ruft die Funktionen des Druckers ab, die gemäß dem XML-Druckschema formatiert sind.

Syntax

HRESULT GetPrintCapabilitiesThunk2(
  _In_      HPTPROVIDER hProvider,
  _In_      BYTE        *pPrintTicket,
  _In_      INT         cbPrintTicket,
  _Out_     BYTE        **ppbPrintCapabilities,
  _Out_     INT         *pcbPrintCapabilitiesLength,
  _Out_opt_ BSTR        *pbstrErrorMessage
);

Parameter

hProvider [in]

Ein Handle für einen offenen Druckticketanbieter. Dieses Handle wird von der BindPTProviderThunk-Funktion zurückgegeben.

pPrintTicket [in]

Der Puffer, der die Druckticketdaten enthält, ausgedrückt in XML, wie im Druckschema beschrieben.

cbPrintTicket [in]

Die Größe des Puffers, auf den pPrintTicket verweist, in Bytes.

ppbPrintCapabilities [out]

Die Adresse des Puffers, der von dieser Funktion zugewiesen wird und die gültigen Druckfunktioneninformationen enthält, die als XML codiert sind. 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.

pcbPrintCapabilitiesLength [out]

Die Größe des Puffers, auf den ppbPrintCapabilities verweist, in Bytes.

pbstrErrorMessage [out, optional]

Ein Zeiger auf eine Zeichenfolge, die angibt, was, falls überhaupt, für pPrintTicket ungültig ist. Wenn er gültig ist, 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, 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
Prntvpt.dll

Siehe auch

PTGetPrintCapabilities

Druckschema

Drucken

Druckspooler-API-Funktionen