SpLsaModeInitializeFn callback function (ntsecpkg.h)

Article
02/22/2024

The SpLsaModeInitialize function is called once by the Local Security Authority (LSA) for each registered security support provider/authentication package (SSP/AP) DLL it loads. This function provides the LSA with pointers to the functions implemented by each security package in the SSP/AP DLL.

Syntax

SpLsaModeInitializeFn Splsamodeinitializefn;

NTSTATUS Splsamodeinitializefn(
  [in]  ULONG LsaVersion,
  [out] PULONG PackageVersion,
  [out] PSECPKG_FUNCTION_TABLE *ppTables,
  [out] PULONG pcTables
)
{...}

Parameters

[in] LsaVersion

The version of the LSA.

[out] PackageVersion

Pointer to a ULONG that returns the SSP/AP DLL version number.

[out] ppTables

Pointer to an array of SECPKG_FUNCTION_TABLE structures. Each structure is a table of pointers to the functions implemented by a security package deployed in the SSP/AP DLL.

[out] pcTables

Pointer that returns the number of elements in the array pointed to by the ppTables parameter.

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 SpLsaModeInitialize function must be implemented by SSP/AP DLLs.

The ppTables parameter should contain one SECPKG_FUNCTION_TABLE for each security package deployed in the DLL.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntsecpkg.h