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 |
|---|---|
|
Der zurückgegebene Domänenname darf nicht länger als 15 Zeichen sein. |
|
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 |