Función SplIsSessionZero (winsplp.h)
La función SplIsSessionZero determina si se emitió un determinado trabajo de impresión (identificador de impresión más identificador de trabajo) en la sesión cero.
Sintaxis
DWORD SplIsSessionZero(
[in] HANDLE hPrinter,
DWORD JobId,
[out] BOOL *pIsSessionZero
);
Parámetros
[in] hPrinter
Identificador de la impresora.
JobId
Especifica el trabajo de impresión.
[out] pIsSessionZero
Puntero a una ubicación de memoria que se establece en TRUE si sessionID para la sesión es cero; de lo contrario, este valor se establece en FALSE.
Valor devuelto
Si se ejecuta correctamente, la función SplIsSessionZero devuelve ERROR_SUCCESS; de lo contrario, esta función devuelve un código de error win32.
Comentarios
Un controlador que muestra elementos de interfaz de usuario personalizados puede usar la función SplIsSessionZero para determinar si el trabajo actual se emitió en la sesión 0. Este controlador puede usar esta información para permitir que presente elementos de la interfaz de usuario en la sesión del usuario, en lugar de en la sesión cero. Una función relacionada, SplPromptUIInUsersSession, muestra un cuadro de mensaje estándar de Windows en la sesión del usuario.
Si tiene previsto usar esta función en un controlador destinado a ejecutarse en Windows 2000, debe cargar spoolss.dll mediante una llamada a la función LoadLibrary y, a continuación, buscar la dirección de esta función dentro de ese archivo DLL mediante una llamada a la función GetProcAddress . Si se produce un error en la llamada a GetProcAddress , debe usar un mecanismo alternativo para mostrar los elementos de la interfaz de usuario.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Esta función está disponible en Windows XP y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Encabezado | winsplp.h (incluya Winsplp.h) |
| Library | Spoolss.lib |
| Archivo DLL | Spoolss.dll |