CorePrinterDriverInstalled function

Article
01/07/2021

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)