Compartilhar via


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

[A função WlxGetSourceDesktop não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

Chamado por GINA para determinar o nome e o identificador da área de trabalho que era atual antes do Winlogon mudar para a área de trabalho do Winlogon.

Nota As DLLs GINA são ignoradas no Windows Vista.
 
GINA pode usar essa função para modificar seu comportamento, dependendo da área de trabalho de origem.

Sintaxe

PWLX_GET_SOURCE_DESKTOP PwlxGetSourceDesktop;

BOOL PwlxGetSourceDesktop(
  [in]  HANDLE hWlx,
  [out] PWLX_DESKTOP *ppDesktop
)
{...}

Parâmetros

[in] hWlx

Especifica o identificador winlogon passado para GINA na chamada WlxInitialize .

[out] ppDesktop

Recebe um ponteiro para uma estrutura WLX_DESKTOP que contém as informações necessárias que descrevem a área de trabalho. Esse ponteiro pode ser liberado com LocalFree.

Valor retornado

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

Código de retorno Descrição
TRUE
A chamada foi bem-sucedida.
FALSE
Falha na chamada.

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

Localfree

WLX_DESKTOP

WlxInitialize