Función GetPrinterDriverDirectory

La función GetPrinterDriverDirectory recupera la ruta de acceso del directorio printer-driver.

Sintaxis

BOOL GetPrinterDriverDirectory(
  _In_  LPTSTR  pName,
  _In_  LPTSTR  pEnvironment,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pDriverDirectory,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parámetros

pName [in]

Puntero a una cadena terminada en null que especifica el nombre del servidor en el que reside el controlador de impresora. Si este parámetro es NULL, se recupera la ruta de acceso del directorio del controlador local.

pEnvironment [in]

Puntero a una cadena terminada en null que especifica el entorno (por ejemplo, Windows x86, Windows IA64 o Windows x64). Si este parámetro es NULL, se usa el entorno actual de la aplicación que realiza la llamada y la máquina cliente (no de la aplicación de destino y del servidor de impresión).

Nivel [in]

Nivel de estructura. Este valor debe ser 1.

pDriverDirectory [out]

Puntero a un búfer que recibe la ruta de acceso.

cbBuf [in]

Tamaño del búfer al que apunta pDriverDirectory .

pcbNeededed [out]

Puntero a un valor que especifica el número de bytes copiados si la función se realiza correctamente o el número de bytes necesarios si cbBuf es demasiado pequeño.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Nota:

Se trata de una función de bloqueo o sincrónica y podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación de controladores de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winspool.h (incluye Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Winspool.drv
Nombres Unicode y ANSI	GetPrinterDriverDirectoryW (Unicode) y GetPrinterDriverDirectoryA (ANSI)

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

AddPrinterDriver