Função SplPromptUIInUsersSession (winsplp.h)

A SplPromptUIInUsersSession função exibe uma caixa de mensagem padrão na sessão indicada pelo identificador da impressora e pela ID do trabalho.

Sintaxe

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

Parâmetros

[in] hPrinter

Manipule para a impressora.

[in] JobId

Especifica o trabalho de impressão.

[in] pUIParams

Ponteiro para uma estrutura SHOWUIPARAMS que contém valores que determinam a aparência e o comportamento da caixa de mensagem.

[out] pResponse

Ponteiro para um local de memória que contém a resposta do usuário ou a constante IDASYNC. Para obter mais informações, consulte a seção Comentários.

Retornar valor

Em caso de êxito, a SplPromptUIInUsersSession função retorna TRUE; caso contrário, retorna FALSE.

Comentários

Se pUIParams ->bWait for FALSE, essa função retornará imediatamente sem aguardar a resposta do usuário. Nesse caso, *pResponse é definido como IDASYNC.

Se você planeja usar essa função em um driver destinado a ser executado no Windows 2000, você deve carregar spoolss.dll por uma chamada para a função LoadLibrary e, em seguida, encontrar o endereço dessa função dentro dessa DLL por uma chamada para a função GetProcAddress . (LoadLibrary e GetProcAddress são descritos na documentação do SDK do Microsoft Windows.) Se a chamada para GetProcAddress falhar, você deverá usar um mecanismo alternativo para exibir elementos de interface do usuário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	A função SplPromptUIInUsersSession está disponível no Windows XP e posterior
Plataforma de Destino	Área de Trabalho
Cabeçalho	winsplp.h (inclua Winsplp.h)
Biblioteca	Spoolss.lib
DLL	Spoolss.dll

Confira também

SHOWUIPARAMS

SplIsSessionZero