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 |