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