función Msv1_0SubAuthenticationRoutineEx (subauth.h)

Realiza la autenticación del servicio de acceso remoto cuando se solicita la subautenticación mediante una llamada a la función LogonUser .

Las credenciales e información de la entidad de seguridad de la base de datos administrador de cuentas de seguridad (SAM) se pasan a esta función para la autenticación.

Esta función se implementa mediante archivos DLL de paquetes de subautenticación personalizados para su uso con el paquete de autenticación MSV1_0.

Esta función solo se llama para una autenticación no interactiva, solo en el servidor de autenticación donde reside la cuenta y solo si se registra un archivo DLL de subautenticación bajo la clave correcta en el Registro.

Sintaxis

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 el nivel de información proporcionado en el parámetro LogonInformation . Este parámetro se establece normalmente en NetlogonInteractiveInformation.

[in] LogonInformation

Puntero a una estructura de NETLOGON_LOGON_IDENTITY_INFO . Los miembros de esta estructura contienen información sobre el usuario que inicia sesión. Se omite el miembro LogonDomainName de esta estructura.

[in] Flags

Opcional. Contiene marcas que describen las circunstancias del inicio de sesión. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
MSV1_0_PASSTHRU	Autenticación de paso a través. El usuario no se conecta a este equipo.
MSV1_0_GUEST_LOGON	Se trata de un reintento del inicio de sesión mediante la cuenta de usuario INVITADO.

[in] UserAll

Puntero a una estructura de USER_ALL_INFORMATION que contiene la descripción del usuario tal como se devuelve de la base de datos SAM.

[in] UserHandle

Identificador de la cuenta de usuario.

[in, out] ValidationInfo

Puntero a una estructura de MSV1_0_VALIDATION_INFO.

[out] ActionsPerformed

Lista de acciones realizadas.

Valor devuelto

Esta función debe devolver uno de los valores siguientes.

Código devuelto	Descripción
STATUS_SUCCESS	No se produjo ningún error.
STATUS_ACCOUNT_DISABLED	La cuenta está deshabilitada.
STATUS_ACCOUNT_EXPIRED	La cuenta ha expirado.
STATUS_ACCOUNT_LOCKED_OUT	Se ha bloqueado la cuenta.
STATUS_INVALID_INFO_CLASS	LogonLevel no es válido.
STATUS_INVALID_WORKSTATION	El usuario no está autorizado para iniciar sesión en la estación de trabajo especificada.
STATUS_NO_SUCH_USER	El usuario especificado no tiene ninguna cuenta.
STATUS_PASSWORD_EXPIRED	La contraseña ha expirado.
STATUS_PASSWORD_MUST_CHANGE	La cuenta está marcada para indicar que la contraseña debe cambiarse en el siguiente inicio de sesión.
STATUS_WRONG_PASSWORD	La contraseña no era válida.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	subauth.h