Share via


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

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

Chamado por GINA para criar áreas de trabalho de aplicativo alternativas para o usuário.

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

Sintaxe

PWLX_CREATE_USER_DESKTOP PwlxCreateUserDesktop;

BOOL PwlxCreateUserDesktop(
  [in]  HANDLE hWlx,
  [in]  HANDLE hToken,
  [in]  DWORD Flags,
  [in]  PWSTR pszDesktopName,
  [out] PWLX_DESKTOP *ppDesktop
)
{...}

Parâmetros

[in] hWlx

Especifica o identificador winlogon passado para GINA na chamada WlxInitialize .

[in] hToken

Especifica o identificador para o token do usuário para o qual a área de trabalho está sendo criada.

[in] Flags

Especifica o acesso à área de trabalho. Especifique um dos itens a seguir.

Valor Significado
WLX_CREATE_INSTANCE_ONLY
Especifica que somente essa instância do usuário tem acesso.
WLX_CREATE_USER
Especifica que qualquer instância desse usuário tem acesso.

[in] pszDesktopName

Especifica o nome da área de trabalho a ser criada.

[out] ppDesktop

Se a área de trabalho for criada, retornará um ponteiro para uma estrutura WLX_DESKTOP para a nova área de trabalho. Esse ponteiro pode ser usado em uma chamada para WlxSetReturnDesktop para torná-lo a área de trabalho atual depois que um evento SAS é processado.

Valor retornado

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

Código de retorno Descrição
TRUE
A área de trabalho foi criada.
FALSE
A área de trabalho não foi criada.

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

WlxInitialize

WlxSetReturnDesktop