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

Artigo
08/28/2023

[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

Compartilhar via