LsaApInitializePackage function
Called once by the Local Security Authority (LSA) during system initialization to provide the authentication package a chance to initialize itself.
Syntax
NTSTATUS LsaApInitializePackage( _In_ ULONG AuthenticationPackageId, _In_ PLSA_DISPATCH_TABLE LsaDispatchTable, _In_opt_ PLSA_STRING Database, _In_opt_ PLSA_STRING Confidentiality, _Out_ PLSA_STRING *AuthenticationPackageName );
Parameters
- 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.
Remarks
This function must be implemented by authentication packages.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
See also