PTOpenProviderEx-Funktion (prntvpt.h)

Artikel
03/06/2024

Öffnet eine instance eines Druckticketanbieters.

Syntax

HRESULT PTOpenProviderEx(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwMaxVersion,
        DWORD       dwPrefVersion,
  [out] HPTPROVIDER *phProvider,
  [out] DWORD       *pUsedVersion
);

Parameter

[in] pszPrinterName

Ein Zeiger auf den vollständigen Namen einer Druckwarteschlange.

dwMaxVersion

Die neueste Version des Vom Aufrufer unterstützten Druckschemas .

dwPrefVersion

Die Vom Aufrufer angeforderte Version des Druckschemas.

[out] phProvider

Ein Zeiger auf ein Handle für den Anbieter.

[out] pUsedVersion

Ein Zeiger auf die Version des Druckschemas, die der Druckticketanbieter verwendet.

Rückgabewert

Wenn der Vorgang erfolgreich ist, wird der Rückgabewert S_OK, andernfalls enthält das HRESULT einen Fehlercode.

Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung.

Hinweise

Hinweis Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierung ab – Faktoren, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.

Der PszPrinterName-Parameter muss der vollständige Name sein, nicht der abgeschnittene Name, wie er möglicherweise in einem DEVMODE angezeigt wird.

Die erste Version des Druckschemas wurde mit Windows Vista veröffentlicht und ist Version 1. Wenn der Druckticketanbieter prefVersion nicht unterstützt, öffnet PTOpenProviderEx erfolgreich ein Handle und gibt eine frühere Version in usedVersion zurück.

Um ein Ressourcenleck zu vermeiden, muss phProvider mit PTCloseProvider geschlossen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	prntvpt.h
Bibliothek	Prntvpt.lib
DLL	Prntvpt.dll

Weitere Informationen

Druckschema

Druckspooler-API-Funktionen

Drucken

Freigeben über