Export (0) Print
Expand All
Expand Minimize

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




Community Additions

© 2014 Microsoft