PTOpenProvider-Funktion (prntvpt.h)

Artikel
03/04/2024

Öffnet eine instance eines Druckticketanbieters.

Syntax

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

Parameter

[in] pszPrinterName

Ein Zeiger auf den vollständigen Namen einer Druckwarteschlange.

dwVersion

Die Vom Aufrufer angeforderte Version des Druckschemas .

[out] phProvider

Ein Zeiger auf ein Handle für den Anbieter.

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.

pszPrinterName muss der vollständige Name sein, nicht der abgeschnittene Name, wie er möglicherweise in einer DEVMODE-Instanz angezeigt wird.

Die erste Version des Druckschemas wurde mit Windows Vista veröffentlicht und ist Version 1. Dieser Vorgang schlägt fehl, wenn die Version nicht unterstützt wird. Vergleichen Sie dies mit PTOpenProviderEx , das einen Anbieter öffnet, auch wenn er nur Versionen unterstützt, die früher als angefordert sind.

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