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 |