Freigeben über

Msv1_0SubAuthenticationRoutineEx-Funktion (subauth.h)

  • Artikel

Führt die Remotezugriffsdienstauthentifizierung aus, wenn die Unterauthentifizierung durch Aufrufen der LogonUser-Funktion angefordert wird.

Die Anmeldeinformationen und Informationen des Sicherheitsprinzipals aus der SAM-Datenbank (Security Accounts Manager ) werden zur Authentifizierung an diese Funktion übergeben.

Diese Funktion wird von benutzerdefinierten Unterauthentifizierungspaket-DLLs für die Verwendung mit dem MSV1_0-Authentifizierungspakets implementiert.

Diese Funktion wird nur für eine nicht interaktive Authentifizierung aufgerufen, nur auf dem Authentifizierungsserver, auf dem sich das Konto befindet, und nur, wenn eine Unterauthentifizierungs-DLL unter dem richtigen Schlüssel in der Registrierung registriert ist.

Syntax

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

Parameter

[in] LogonLevel

Gibt die Im Parameter LogonInformation angegebene Informationsebene an. Dieser Parameter ist normalerweise auf NetlogonInteractiveInformation festgelegt.

[in] LogonInformation

Ein Zeiger auf eine NETLOGON_LOGON_IDENTITY_INFO-Struktur . Mitglieder dieser Struktur enthalten Informationen über den Benutzer, der sich anmeldet. Das LogonDomainName-Element dieser Struktur wird ignoriert.

[in] Flags

Optional. Enthält Flags, die die Umstände der Anmeldung beschreiben. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
MSV1_0_PASSTHRU
 Passthrough-Authentifizierung Der Benutzer stellt keine Verbindung mit diesem Computer her.
MSV1_0_GUEST_LOGON
 Dies ist ein Wiederholungsversuch der Anmeldung mithilfe des GUEST-Benutzerkontos.

[in] UserAll

Ein Zeiger auf eine USER_ALL_INFORMATION-Struktur , die die Beschreibung des Benutzers enthält, wie sie von der SAM-Datenbank zurückgegeben wird.

[in] UserHandle

Ein Handle für das Benutzerkonto.

[in, out] ValidationInfo

Ein Zeiger auf eine MSV1_0_VALIDATION_INFO-Struktur.

[out] ActionsPerformed

Die Liste der ausgeführten Aktionen.

Rückgabewert

Diese Funktion muss einen der folgenden Werte zurückgeben.

Rückgabecode Beschreibung
STATUS_SUCCESS
 Es ist kein Fehler aufgetreten.
STATUS_ACCOUNT_DISABLED
 Das Konto ist deaktiviert.
STATUS_ACCOUNT_EXPIRED
 Das Konto ist abgelaufen.
STATUS_ACCOUNT_LOCKED_OUT
 Das Konto ist gesperrt.
STATUS_INVALID_INFO_CLASS
 LogonLevel ist ungültig.
STATUS_INVALID_WORKSTATION
 Der Benutzer ist nicht autorisiert, sich bei der angegebenen Arbeitsstation anzumelden.
STATUS_NO_SUCH_USER
 Der angegebene Benutzer verfügt über kein Konto.
STATUS_PASSWORD_EXPIRED
 Das Kennwort ist abgelaufen.
STATUS_PASSWORD_MUST_CHANGE
 Das Konto ist gekennzeichnet, um anzugeben, dass das Kennwort bei der nächsten Anmeldung geändert werden muss.
STATUS_WRONG_PASSWORD
 Das Kennwort war ungültig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile subauth.h