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.
| Código de retorno | Descrição |
|---|---|
|
A chamada de função foi bem-sucedida. |
|
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 |