Função SplIsSessionZero (winsplp.h)

  • Artigo

A função SplIsSessionZero determina se um determinado trabalho de impressão (identificador de impressão mais ID do trabalho) foi emitido na sessão zero.

Sintaxe

DWORD SplIsSessionZero(
  [in]  HANDLE hPrinter,
        DWORD  JobId,
  [out] BOOL   *pIsSessionZero
);

Parâmetros

[in] hPrinter

Um identificador para a impressora.

JobId

Especifica o trabalho de impressão.

[out] pIsSessionZero

Ponteiro para um local de memória definido como TRUE se o SessionID da sessão for zero; caso contrário, esse valor será definido como FALSE.

Retornar valor

Em caso de êxito, a função SplIsSessionZero retorna ERROR_SUCCESS; caso contrário, essa função retornará um código de erro Win32.

Comentários

Um driver que exibe elementos personalizados da interface do usuário pode usar a função SplIsSessionZero para determinar se o trabalho atual foi emitido na sessão 0. Esse driver pode usar essas informações para permitir que ele apresente elementos de interface do usuário na sessão do usuário, em vez de na sessão zero. Uma função relacionada, SplPromptUIInUsersSession, exibe uma caixa de mensagem padrão do Windows na sessão do usuário.

Se você planeja usar essa função em um driver destinado a ser executado no Windows 2000, é necessário 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 . 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 Essa função 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

SplPromptUIInUsersSession