GetCorePrinterDrivers-Funktion

Ruft GUID, Version und Datum der angegebenen Kerndruckertreiber und den Pfad zu ihren Paketen ab.

Syntax

HRESULT GetCorePrinterDrivers(
  _In_  LPCTSTR              pszServer,
  _In_  LPCTSTR              pszEnvironment,
  _In_  LPCTSTR              pszzCoreDriverDependencies,
  _In_  DWORD                cCorePrinterDrivers,
  _Out_ PCORE_PRINTER_DRIVER pCorePrinterDrivers
);

Parameter

pszServer [ In]

Ein Zeiger auf eine konstante, mit NULL beendete Zeichenfolge, die den Namen des Druckerservers angibt. Verwenden Sie NULL für den lokalen Computer.

pszEnvironment [ In]

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

pszzCoreDriverDependencies [ In]

Ein Zeiger auf eine mit NULL beendete mehrfache Zeichenfolge, die die GUIDs der Hauptdruckertreiber angibt.

cCorePrinterDrivers [ In]

Die Anzahl der Zeichenfolgen in pszzCoreDriverDependencies.

pCorePrinterDrivers [ out]

Ein Zeiger auf ein Array von mindestens einer CORE _ PRINTER _ DRIVER-Struktur.

Rückgabewert

Wenn der Vorgang erfolgreich ist, ist der Rückgabewert S _ OK, andernfalls enthält das HRESULT einen Fehlercode.

Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung.

Hinweise

Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu kommen, dass die Anwendung nicht reagiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
Spoolss.dll
Unicode- und ANSI-Name
GetCorePrinterDriversW (Unicode) und GetCorePrinterDriversA (ANSI)

Siehe auch

Drucken

Druckspooler-API-Funktionen