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

Weitere Informationen

SECPKG_USER_FUNCTION_TABLE