SpGetUserInfoFn-Rückruffunktion (ntsecpkg.h)

Die SpGetUserInfo-Funktion ruft Informationen zu einer Anmeldesitzung ab.

Syntax

SpGetUserInfoFn Spgetuserinfofn;

NTSTATUS Spgetuserinfofn(
  [in]  PLUID LogonId,
  [in]  ULONG Flags,
  [out] PSecurityUserData *UserData
)
{...}

Parameter

[in] LogonId

Zeiger auf eine LUID , die die Anmeldesitzung enthält, für die Informationen abgerufen werden sollen.

[in] Flags

Gibt die zulässige Länge des Domänennamens als einen der folgenden Werte an.

Wert	Bedeutung
NO_LONG_NAMES	Der zurückgegebene Domänenname darf nicht länger als 15 Zeichen sein.
UNDERSTANDS_LONG_NAMES	Der zurückgegebene Domänenname kann länger als 15 Zeichen sein.

[out] UserData

Zeiger auf einen Zeiger auf eine SecurityUserData-Struktur . Wenn der Funktionsaufruf erfolgreich ist, werden die Benutzerinformationen in dieser Struktur zurückgegeben. Das Sicherheitspaket sollte den Arbeitsspeicher für diese Struktur im Adressraum des Aufrufers zuordnen. Der Aufrufer ist für das Freigeben des Puffers verantwortlich, indem er die FreeContextBuffer-Funktion aufruft.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für einen Fehler angibt.

Hinweise

Der Flags-Wert NO_LONG_NAMES bietet Kompatibilität mit Microsoft NTLM.

SSP/APs müssen die SpGetUserInfo-Funktion implementieren. Der tatsächliche Name, der der Implementierung zugewiesen wird, liegt jedoch beim Entwickler.

Ein Zeiger auf die SpGetUserInfo-Funktion ist in der SECPKG_FUNCTION_TABLE Struktur verfügbar, die von der SpLsaModeInitialize-Funktion empfangen wird.

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

Weitere Informationen

FreeContextBuffer

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize