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

[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.

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.

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

Confira também

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS