SpInstanceInit function
The SpInstanceInit function is called once for each security package contained in an SSP/AP, when the SSP/AP is loaded into a client/server process. Security packages should use this function to perform any user mode-specific initialization.
Syntax
NTSTATUS SpInstanceInit( _In_ ULONG Version, _In_ PSECPKG_DLL_FUNCTIONS FunctionTable, _Out_ PVOID *UserFunctions );
Parameters
- Version [in]
-
The version of the Local Security Authority (LSA).
- FunctionTable [in]
-
Pointer to a SECPKG_DLL_FUNCTIONS structure containing the support functions that the security package can use in user-mode.
- UserFunctions [out]
-
Pointer that receives the address of a table of user-mode functions supported by the security package.
Return value
If the function succeeds, return STATUS_SUCCESS.
If the function fails, return an NTSTATUS code that indicates the reason it failed.
Remarks
The SpInstanceInit function is called once when the SSP/AP is loaded into the user-mode process, after the SpUserModeInitialize function is called.
SSP/APs must implement the SpInstanceInit function; however, the actual name given to the implementation is up to the developer.
A pointer to the SpInstanceInit function is available in the SECPKG_USER_FUNCTION_TABLE structure received from the SpUserModeInitialize function.
Requirements
|
Minimum supported client | Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
See also
Send comments about this topic to Microsoft
Build date: 1/2/2013
