Edit

Share via

LsaLookupAuthenticationPackage function (ntsecapi.h)

  • Article

The LsaLookupAuthenticationPackage function obtains the unique identifier of an authentication package.

Syntax

NTSTATUS LsaLookupAuthenticationPackage(
  [in]  HANDLE      LsaHandle,
  [in]  PLSA_STRING PackageName,
  [out] PULONG      AuthenticationPackage
);

Parameters

[in] LsaHandle

Handle obtained from a previous call to LsaRegisterLogonProcess or LsaConnectUntrusted.

[in] PackageName

Pointer to an LSA_STRING structure that specifies the name of the authentication package. The package name must not exceed 127 bytes in length. The following table lists the names of the Microsoft-provided authentication packages.

Value Meaning
MSV1_0_PACKAGE_NAME
 ANSI version of the MSV1_0 authentication package name.
MICROSOFT_KERBEROS_NAME_A
 ANSI version of the Kerberos authentication package name.
NEGOSSP_NAME_A
 ANSI version of the Negotiate authentication package name.

[out] AuthenticationPackage

Pointer to a ULONG that receives the authentication package identifier.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code. The following are possible error codes.

Return code Description
STATUS_NO_SUCH_PACKAGE
 The specified authentication package is unknown to the LSA.
STATUS_NAME_TOO_LONG
 The authentication package name exceeds 127 bytes.
 

For more information, see LSA Policy Function Return Values.

The LsaNtStatusToWinError function converts an NTSTATUS code to a Windows error code.

Remarks

The authentication package identifier is used in calls to authentication functions such as LsaLogonUser and LsaCallAuthenticationPackage.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header ntsecapi.h
Library Secur32.lib
DLL Secur32.dll

See also

LsaCallAuthenticationPackage

LsaLogonUser