This topic has not yet been rated - Rate this topic

LsaLookupAuthenticationPackage function

Applies to: desktop apps only

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

LsaHandle [in]

Handle obtained from a previous call to LsaRegisterLogonProcess or LsaConnectUntrusted.

PackageName [in]

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.

ValueMeaning
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.

 

AuthenticationPackage [out]

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 codeDescription
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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Ntsecapi.h

Library

Secur32.lib

DLL

Secur32.dll

See also

LsaLogonUser
LsaCallAuthenticationPackage

 

 

Send comments about this topic to Microsoft

Build date: 3/13/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ