Edit

Share via

LSA_AP_INITIALIZE_PACKAGE callback function (ntsecpkg.h)

  • Article

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

Syntax

LSA_AP_INITIALIZE_PACKAGE LsaApInitializePackage;

NTSTATUS LsaApInitializePackage(
  [in]           ULONG AuthenticationPackageId,
  [in]           PLSA_DISPATCH_TABLE LsaDispatchTable,
  [in, optional] PLSA_STRING Database,
  [in, optional] PLSA_STRING Confidentiality,
  [out]          PLSA_STRING *AuthenticationPackageName
)
{...}

Parameters

[in] AuthenticationPackageId

The identifier the LSA has assigned to the authentication package.

[in] LsaDispatchTable

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.

[in, optional] Database

This parameter is not used; it is NULL.

[in, optional] Confidentiality

This parameter is not used; it is NULL.

[out] AuthenticationPackageName

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.

Remarks

This function must be implemented by authentication packages.

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

See also

AllocateLsaHeap