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.

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]

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.

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

Ntsecpkg.h

See also

SECPKG_USER_FUNCTION_TABLE
SpUserModeInitialize

 

 

Community Additions

ADD
Show:
© 2014 Microsoft