SpInstanceInitFn-Rückruffunktion (ntsecpkg.h)

Die SpInstanceInit-Funktion wird einmal für jedes Sicherheitspaket aufgerufen, das in einem SSP/AP enthalten ist, wenn der SSP/AP in einen Client/Server-Prozess geladen wird. Sicherheitspakete sollten diese Funktion verwenden, um eine benutzermodusspezifische Initialisierung durchzuführen.

Syntax

SpInstanceInitFn Spinstanceinitfn;

NTSTATUS Spinstanceinitfn(
  [in]  ULONG Version,
  [in]  PSECPKG_DLL_FUNCTIONS FunctionTable,
  [out] PVOID *UserFunctions
)
{...}

Parameter

[in] Version

Die Version der lokalen Sicherheitsautorität (Local Security Authority , LSA).

[in] FunctionTable

Zeiger auf eine SECPKG_DLL_FUNCTIONS-Struktur , die die Supportfunktionen enthält, die das Sicherheitspaket im Benutzermodus verwenden kann.

[out] UserFunctions

Dieser Parameter wird nicht verwendet.

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 SpInstanceInit-Funktion wird einmal aufgerufen, wenn der SSP/AP in den Benutzermodusprozess geladen wird, nachdem die Funktion SpUserModeInitialize aufgerufen wurde.

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

Ein Zeiger auf die SpInstanceInit-Funktion ist in der SECPKG_USER_FUNCTION_TABLE-Struktur verfügbar, die von der SpUserModeInitialize-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

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize