Compartir a través de


Función SplPromptUIInUsersSession (winsplp.h)

La función SplPromptUIInUsersSession muestra un cuadro de mensaje estándar en la sesión indicada por el identificador de la 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 función SplPromptUIInUsersSession devuelve TRUE; de lo contrario, devuelve FALSE.

Observaciones

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 tienes previsto usar esta función en un controlador destinado a ejecutarse en Windows 2000, debes 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. ( LoadLibrary y GetProcAddress se describen en la documentación del SDK de Microsoft Windows). 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 Valor
cliente mínimo admitido La función SplPromptUIInUsersSession está disponible en Windows XP y versiones posteriores.
de la plataforma de destino de Escritorio
encabezado de winsplp.h (incluya Winsplp.h)
biblioteca de Spoolss.lib
DLL de Spoolss.dll

Consulte también

SHOWUIPARAMS

SplIsSessionZero