SpUserModeInitializeFn-Rückruffunktion (ntsecpkg.h)

Die SpUserModeInitialize-Funktion wird aufgerufen, wenn eine SSP/AP-DLL ( Security Support Provider/Authentication Package ) in den Prozessbereich einer Client-/Serveranwendung geladen wird. Diese Funktion stellt die SECPKG_USER_FUNCTION_TABLE Tabellen für jedes Sicherheitspaket in der SSP/AP-DLL bereit.

Syntax

SpUserModeInitializeFn Spusermodeinitializefn;

NTSTATUS Spusermodeinitializefn(
  [in]  ULONG LsaVersion,
  [out] PULONG PackageVersion,
  [out] PSECPKG_USER_FUNCTION_TABLE *ppTables,
  [out] PULONG pcTables
)
{...}

Parameter

[in] LsaVersion

Die Version der Sicherheitsanbieter-DLL (entweder Secur32.dll oder Security.dll).

[out] PackageVersion

Zeiger, der die Version der SSP/AP-DLL zurückgibt.

[out] ppTables

Zeiger, der ein Array von SECPKG_USER_FUNCTION_TABLE Strukturen zurückgibt. Jede Struktur ist eine Tabelle mit Zeigern auf die Benutzermodusfunktionen, die von einem Sicherheitspaket implementiert werden, das in der SSP/AP-DLL bereitgestellt wird.

[out] pcTables

Zeiger, der die Anzahl der Elemente im Array zurückgibt, auf das der ppTables-Parameter verweist.

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 den Fehler angibt.

Hinweise

Die SpUserModeInitialize-Funktion muss von SSP/AP-DLLs implementiert werden, die Sicherheitspakete im Benutzermodus enthalten.

Der ppTables-Parameter sollte eine SECPKG_USER_FUNCTION_TABLE für jedes in der DLL bereitgestellte Sicherheitspaket für den Benutzermodus enthalten. Weitere Informationen zum Bereitstellen von Sicherheitspaketen in DLLs finden Sie unter Initialisierung des Benutzermodus.

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

SECPKG_USER_FUNCTION_TABLE