Compartilhar via


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

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

Chamado por GINA para atribuir proteção ao programa shell de um usuário recém-conectado.

Nota As DLLs GINA são ignoradas no Windows Vista.
 
O processo de shell deve ser criado em um estado suspenso e, em seguida, a função WlxAssignShellProtection deve ser chamada para aplicar a proteção correta ao processo de shell.

Essa função foi substituída pela função CreateProcessAsUser da API do Windows.

Sintaxe

PWLX_ASSIGN_SHELL_PROTECTION PwlxAssignShellProtection;

int PwlxAssignShellProtection(
  [in] HANDLE hWlx,
  [in] HANDLE hToken,
  [in] HANDLE hProcess,
  [in] HANDLE hThread
)
{...}

Parâmetros

[in] hWlx

Especifica o identificador winlogon passado para GINA na chamada WlxInitialize .

[in] hToken

Especifica o identificador para um token primário.

[in] hProcess

Especifica o identificador para o processo a ser modificado. O processo deve ser criado no estado suspenso e esse deve ser o identificador retornado na estrutura PROCESS_INFORMATION .

[in] hThread

Especifica o identificador para o thread inicial do processo.

Retornar valor

A função WlxAssignShellProtection retorna todos os erros encontrados ao tentar atribuir proteção.

Comentários

A função CreateProcessAsUser da API do Windows substitui WlxAssignShellProtection. Chame CreateProcessAsUser no WlxActivateUserShell para criar o processo de shell e definir suas proteções em uma única chamada.

Requisitos

Requisito Valor
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

Createprocessasuser

WlxActivateUserShell

WlxInitialize