The CorePrinterDriverInstalled function reports whether a core printer driver with a specified GUID, date, and version is installed.
Syntax
HRESULT CorePrinterDriverInstalled(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszEnvironment,
_In_ GUID CoreDriverGUID,
_In_ FILETIME ftDriverDate,
_In_ DWORDLONG dwlDriverVersion,
_Out_ BOOL *pbDriverInstalled
);
Parameters
pszServer [in]
Pointer to a constant, null-terminated string that specifies the name of the print server. Use NULL for the local computer.
pszEnvironment [in]
Pointer to a constant, null-terminated string that specifies the processor architecture (for example, Windows NT x86). This can be NULL.
CoreDriverGUID [in]
The GUID of the core printer driver.
ftDriverDate [in]
The date of the core printer driver.
dwlDriverVersion [in]
The version of the core printer driver.
pbDriverInstalled [out]
A pointer to TRUE if the driver, or a newer version, is installed, FALSE otherwise.
Return value
If the operation succeeds, the return value is S_OK, otherwise the HRESULT will contain an error code.
For more information about COM error codes, see Error Handling.
Remarks
Note:
This is a blocking or synchronous function and might not return immediately. How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation factors that are difficult to predict when writing an application. Calling this function from a thread that manages interaction with the user interface could make the application appear to be unresponsive.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Header | Winspool.h (include Windows.h) |
| Library | Winspool.lib |
| DLL | Spoolss.dll |
| Unicode and ANSI names | CorePrinterDriverInstalledW (Unicode) and CorePrinterDriverInstalledA (ANSI) |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
