função Msv1_0SubAuthenticationRoutineEx (subauth.h)

Artigo
08/26/2023

Executa a autenticação do Serviço de Acesso Remoto quando a subautenticação é solicitada chamando a função LogonUser .

As credenciais e as informações da entidade de segurança do banco de dados SAM ( Gerenciador de Contas de Segurança) são passadas para essa função para autenticação.

Essa função é implementada por DLLs de pacote de subautenticação personalizadas para uso com o pacote de autenticação MSV1_0.

Essa função é chamada apenas para uma autenticação nãointerativa, somente no servidor de autenticação em que a conta reside e somente se uma DLL de subautenticação for registrada sob a chave correta no Registro.

Sintaxe

NTSTATUS Msv1_0SubAuthenticationRoutineEx(
  [in]      NETLOGON_LOGON_INFO_CLASS LogonLevel,
  [in]      PVOID                     LogonInformation,
  [in]      ULONG                     Flags,
  [in]      PUSER_ALL_INFORMATION     UserAll,
  [in]      SAM_HANDLE                UserHandle,
  [in, out] PMSV1_0_VALIDATION_INFO   ValidationInfo,
  [out]     PULONG                    ActionsPerformed
);

Parâmetros

[in] LogonLevel

Especifica o nível de informações fornecidas no parâmetro LogonInformation . Normalmente, esse parâmetro é definido como NetlogonInteractiveInformation.

[in] LogonInformation

Um ponteiro para uma estrutura NETLOGON_LOGON_IDENTITY_INFO . Os membros dessa estrutura contêm informações sobre o usuário que está fazendo logon. O membro LogonDomainName dessa estrutura é ignorado.

[in] Flags

Opcional. Contém sinalizadores que descrevem as circunstâncias do logon. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
MSV1_0_PASSTHRU	Autenticação de passagem. O usuário não está se conectando a este computador.
MSV1_0_GUEST_LOGON	Essa é uma repetição do logon usando a conta de usuário GUEST.

[in] UserAll

Um ponteiro para uma estrutura USER_ALL_INFORMATION que contém a descrição do usuário conforme retornado do banco de dados SAM.

[in] UserHandle

Um identificador para a conta de usuário.

[in, out] ValidationInfo

Um ponteiro para uma estrutura MSV1_0_VALIDATION_INFO.

[out] ActionsPerformed

A lista de ações executadas.

Retornar valor

Essa função deve retornar um dos valores a seguir.

Código de retorno	Descrição
STATUS_SUCCESS	Não houve erro.
STATUS_ACCOUNT_DISABLED	A conta está desabilitada.
STATUS_ACCOUNT_EXPIRED	A conta expirou.
STATUS_ACCOUNT_LOCKED_OUT	A conta está bloqueada.
STATUS_INVALID_INFO_CLASS	LogonLevel não é válido.
STATUS_INVALID_WORKSTATION	O usuário não está autorizado a fazer logon na estação de trabalho especificada.
STATUS_NO_SUCH_USER	O usuário especificado não tem conta.
STATUS_PASSWORD_EXPIRED	A senha expirou.
STATUS_PASSWORD_MUST_CHANGE	A conta está marcada para indicar que a senha deve ser alterada no próximo logon.
STATUS_WRONG_PASSWORD	A senha não era válida.

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	subauth.h