Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

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.


NTSTATUS SpInstanceInit(
  _In_  ULONG                 Version,
  _In_  PSECPKG_DLL_FUNCTIONS FunctionTable,
  _Out_ PVOID                 *UserFunctions


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]

This parameter is not used.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.


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.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]



See also




Community Additions

© 2015 Microsoft