Freigeben über


CorePrinterDriverInstalled-Funktion

Die CorePrinterDriverInstalled-Funktion meldet, ob ein Kerndruckertreiber mit einer angegebenen GUID, datum und Version installiert ist.

Syntax

HRESULT CorePrinterDriverInstalled(
  _In_  LPCTSTR   pszServer,
  _In_  LPCTSTR   pszEnvironment,
  _In_  GUID      CoreDriverGUID,
  _In_  FILETIME  ftDriverDate,
  _In_  DWORDLONG dwlDriverVersion,
  _Out_ BOOL      *pbDriverInstalled
);

Parameter

pszServer [in]

Zeiger auf eine konstante NULL-Zeichenfolge, die den Namen des Druckservers angibt. Verwenden Sie NULL für den lokalen Computer.

pszEnvironment [in]

Zeiger auf eine konstante NULL-Zeichenfolge, die die Prozessorarchitektur angibt (z. B. Windows NT x86). Dies kann NULL sein.

CoreDriverGUID [in]

Die GUID des Hauptdruckertreibers.

ftDriverDate [in]

Das Datum des Hauptdruckertreibers.

dwlDriverVersion [in]

Die Version des Kerndruckertreibers.

pbDriverInstalled [out]

Ein Zeiger auf TRUE , wenn der Treiber oder eine neuere Version installiert ist, andernfalls FALSE .

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.

Bemerkungen

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 Druckertreiberimplementierungsfaktoren ab, 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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Winspool.h (einschließlich Windows.h)
Bibliothek
Winspool.lib
DLL
Spoolss.dll
Unicode- und ANSI-Name
CorePrinterDriverInstalledW (Unicode) und CorePrinterDriverInstalledA (ANSI)

Siehe auch

Drucken

Druckspooler-API-Funktionen