Função SplPromptUIInUsersSession (winsplp.h)
A função SplPromptUIInUsersSession 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.
Valor de retorno
Com êxito, a função SplPromptUIInUsersSession retorna VERDADEIRO; caso contrário, retornará FALSE .
Observações
Se pUIParams –> bWait for FALSE, essa função retornará imediatamente sem aguardar a resposta do usuário. Nesse caso, * pResponse está definido como IDASYNC.
Se você planeja usar essa função em um driver destinado a ser executado no Windows 2000, deverá 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. ( e GetProcAddress do LoadLibrary 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 |
|---|---|
| de cliente com suporte mínimo | A função SplPromptUIInUsersSession está disponível no Windows XP e posterior |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Spoolss.lib |
| de DLL | Spoolss.dll |