função de retorno de chamada PWLX_SET_RETURN_DESKTOP (winwlx.h)

  • Artigo

[A função WlxSetReturnDesktop não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

Chamado por GINA para especificar a área de trabalho de aplicativo alternativa para a qual o Winlogon mudará quando a função de processamento de eventos SAS ( sequência de atenção segura ) atual for concluída.

Nota As DLLs GINA são ignoradas no Windows Vista.
 

Sintaxe

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

Parâmetros

[in] hWlx

Especifica o identificador Winlogon passado para GINA na chamada WlxInitialize .

[in] pDesktop

Ponteiro para informações da área de trabalho sobre a área de trabalho alternativa. Essa área de trabalho é criada chamando a função WlxCreateUserDesktop .

Valor retornado

A função WlxSetReturnDesktop retorna um dos valores a seguir.

Código de retorno Descrição
TRUE
 A chamada de função foi bem-sucedida.
FALSE
 A chamada de função falhou ao definir a área de trabalho de retorno.

Comentários

WlxSetReturnDesktop só pode ser chamado nas rotinas WlxLoggedOnSAS ou WlxWkstaLockedSAS . As tentativas de chamar essa função em outros momentos falharão.

Se um identificador para a área de trabalho for fornecido, o Winlogon duplicará o identificador. Se nenhum identificador for fornecido, o Winlogon tentará abrir a área de trabalho chamada no parâmetro pDesktop . Se a área de trabalho fornecida não for válida ou for o Winlogon ou a área de trabalho de salvamento de tela, a chamada falhará.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winwlx.h

Confira também

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS