Condividi tramite

funzione Msv1_0SubAuthenticationRoutineEx (subauth.h)

  • Articolo

Esegue l'autenticazione del servizio accesso remoto quando viene richiesta l'autenticazione secondaria chiamando la funzione LogonUser .

Le credenziali e le informazioni dell'entità di sicurezza del database Di Gestione account di sicurezza (SAM) vengono passate a questa funzione per l'autenticazione.

Questa funzione viene implementata dalle DLL del pacchetto di sottoutenticazione personalizzate da usare con il pacchetto di autenticazione MSV1_0.

Questa funzione viene chiamata solo per un'autenticazione non attiva, solo nel server di autenticazione in cui risiede l'account e solo se una DLL di sottoutenticazione viene registrata sotto la chiave corretta nel Registro di sistema.

Sintassi

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
);

Parametri

[in] LogonLevel

Specifica il livello di informazioni specificate nel parametro LogonInformation . Questo parametro è in genere impostato su NetlogonInteractiveInformation.

[in] LogonInformation

Puntatore a una struttura NETLOGON_LOGON_IDENTITY_INFO . I membri di questa struttura contengono informazioni sull'utente che esegue l'accesso. Il membro LogonDomainName di questa struttura viene ignorato.

[in] Flags

facoltativo. Contiene flag che descrivono le circostanze dell'accesso. Questo parametro può avere uno dei valori seguenti.

Valore Significato
MSV1_0_PASSTHRU
 Autenticazione pass-through. L'utente non si connette a questo computer.
MSV1_0_GUEST_LOGON
 Si tratta di un nuovo tentativo dell'accesso usando l'account utente GUEST.

[in] UserAll

Puntatore a una struttura USER_ALL_INFORMATION che contiene la descrizione dell'utente come restituito dal database SAM.

[in] UserHandle

Handle per l'account utente.

[in, out] ValidationInfo

Puntatore a una struttura MSV1_0_VALIDATION_INFO.

[out] ActionsPerformed

Elenco delle azioni eseguite.

Valore restituito

Questa funzione deve restituire uno dei valori seguenti.

Codice restituito Descrizione
STATUS_SUCCESS
 Non è stato visualizzato alcun errore.
STATUS_ACCOUNT_DISABLED
 L'account è disabilitato.
STATUS_ACCOUNT_EXPIRED
 L'account è scaduto.
STATUS_ACCOUNT_LOCKED_OUT
 L'account è bloccato.
STATUS_INVALID_INFO_CLASS
 LogonLevel non è valido.
STATUS_INVALID_WORKSTATION
 L'utente non è autorizzato ad accedere alla workstation specificata.
STATUS_NO_SUCH_USER
 L'utente specificato non ha alcun account.
STATUS_PASSWORD_EXPIRED
 La password è scaduta.
STATUS_PASSWORD_MUST_CHANGE
 L'account è contrassegnato per indicare che la password deve essere modificata nell'accesso successivo.
STATUS_WRONG_PASSWORD
 La password non è valida.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione subauth.h