Función GetPrintProcessorDirectory
La función GetPrintProcessorDirectory recupera la ruta de acceso al directorio del procesador de impresión en el servidor especificado.
Sintaxis
BOOL GetPrintProcessorDirectory(
_In_ LPTSTR pName,
_In_ LPTSTR pEnvironment,
_In_ DWORD Level,
_Out_ LPBYTE pPrintProcessorInfo,
_In_ DWORD cbBuf,
_Out_ LPDWORD pcbNeeded
);
Parámetros
-
pName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del servidor. Si este parámetro es NULL, se devuelve una ruta de acceso 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 el servidor de impresión).
-
Nivel [in]
-
Nivel de estructura. Este valor debe ser 1.
-
pPrintProcessorInfo [out]
-
Puntero a un búfer que recibe la ruta de acceso. Tenga en cuenta que, en el caso de los sistemas operativos anteriores a Windows Server 2003 SP 1, la ruta de acceso está en el formato local del servidor, no en el verdadero formato remoto. Por ejemplo, la ruta de acceso se da como "%Windir%\System32\Spool\Prtprocs\%Environment%" en lugar de "\\ServerName\Print$\Prtprocs\%Environment%", incluso cuando se llama a para un servidor remoto. Para los sistemas operativos Windows Server 2003 SP 1 y versiones posteriores, se devuelve la ruta de acceso remota verdadera.
-
cbBuf [in]
-
Tamaño del búfer al que apunta pPrintProcessorInfo.
-
pcbNeeded [ 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 que 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 del controlador 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 |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
GetPrintProcessorDirectoryW (Unicode) y GetPrintProcessorDirectoryA (ANSI) |