Freigeben über


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 NULL-Zeichenfolge, die den Namen des Druckservers angibt. Verwenden Sie NULL für den lokalen Computer.

pszEnvironment [in]

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

pszzCoreDriverDependencies [in]

Ein Zeiger auf eine null-beendete Multizeichenfolge, die die GUIDs der Hauptdruckertreiber angibt.

cCorePrinterDrivers [in]

Die Anzahl der Zeichenfolgen in pszzCoreDriverDependencies.

pCorePrinterDrivers [out]

Ein Zeiger auf ein Array mit mindestens einer CORE_PRINTER_DRIVER Strukturen.

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

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
GetCorePrinterDriversW (Unicode) und GetCorePrinterDriversA (ANSI)

Siehe auch

Drucken

Druckspooler-API-Funktionen