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