CorePrinterDriverInstalled function

The CorePrinterDriverInstalled function reports whether a core printer driver with a specified GUID, date, and version is installed.


HRESULT CorePrinterDriverInstalled(
  _In_  LPCTSTR   pszServer,
  _In_  LPCTSTR   pszEnvironment,
  _In_  GUID      CoreDriverGUID,
  _In_  FILETIME  ftDriverDate,
  _In_  DWORDLONG dwlDriverVersion,
  _Out_ BOOL      *pbDriverInstalled


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.


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.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]


Winspool.h (include Windows.h)





Unicode and ANSI names

CorePrinterDriverInstalledW (Unicode) and CorePrinterDriverInstalledA (ANSI)

See also

Print Spooler API Functions