LsaApInitializePackage function

Called once by the Local Security Authority (LSA) during system initialization to provide the authentication package a chance to initialize itself.


NTSTATUS LsaApInitializePackage(
  _In_     ULONG               AuthenticationPackageId,
  _In_     PLSA_DISPATCH_TABLE LsaDispatchTable,
  _In_opt_ PLSA_STRING         Database,
  _In_opt_ PLSA_STRING         Confidentiality,
  _Out_    PLSA_STRING         *AuthenticationPackageName


AuthenticationPackageId [in]

The identifier the LSA has assigned to the authentication package.

LsaDispatchTable [in]

Pointer to an LSA_DISPATCH_TABLE structure that contains the addresses of LSA functions that can be called by authentication packages. Your custom authentication package should save this information if it requires any of the functions described in LSA Functions Called by Authentication Packages.

Database [in, optional]

This parameter is not used; it is NULL.

Confidentiality [in, optional]

This parameter is not used; it is NULL.

AuthenticationPackageName [out]

Pointer to a pointer to an LSA_STRING structure that receives the name of the authentication package. The authentication package is responsible for allocating the structure and the buffer that contains this string (using the AllocateLsaHeap function) and returning the address of the structure in this parameter. The buffer will be freed by the LSA when it is no longer needed.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS error code. For more information, see LSA Policy Function Return Values.


This function must be implemented by authentication packages.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]



See also