Función SplPromptUIInUsersSession (winsplp.h)

  • Artículo

La SplPromptUIInUsersSession función muestra un cuadro de mensaje estándar en la sesión indicada por el identificador de impresora y el identificador de trabajo.

Sintaxis

BOOL SplPromptUIInUsersSession(
  [in]  HANDLE        hPrinter,
  [in]  DWORD         JobId,
  [in]  PSHOWUIPARAMS pUIParams,
  [out] DWORD         *pResponse
);

Parámetros

[in] hPrinter

Maneje a la impresora.

[in] JobId

Especifica el trabajo de impresión.

[in] pUIParams

Puntero a una estructura SHOWUIPARAMS que contiene valores que determinan la apariencia y el comportamiento del cuadro de mensaje.

[out] pResponse

Puntero a una ubicación de memoria que contiene la respuesta del usuario o la constante IDASYNC. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si se ejecuta correctamente, la SplPromptUIInUsersSession función devuelve TRUE; de lo contrario, devuelve FALSE.

Comentarios

Si pUIParams ->bWait es FALSE, esta función devuelve inmediatamente sin esperar la respuesta del usuario. En ese caso, *pResponse se establece en IDASYNC.

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 esa DLL mediante una llamada a la función GetProcAddress . (LoadLibrary y GetProcAddress se describen en la documentación de Microsoft Windows SDK). Si se produce un error en la llamada a GetProcAddress, debe usar un mecanismo alternativo para mostrar elementos de la interfaz de usuario.

Requisitos

Requisito Value
Cliente mínimo compatible La función SplPromptUIInUsersSession 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

Consulte también

SHOWUIPARAMS

SplIsSessionZero