Skip to content

Latest commit

 

History

History
135 lines (96 loc) · 4.87 KB

nc-ntsecpkg-lsa_ap_call_package.md

File metadata and controls

135 lines (96 loc) · 4.87 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NC:ntsecpkg.LSA_AP_CALL_PACKAGE
LSA_AP_CALL_PACKAGE (ntsecpkg.h)
Called by the Local Security Authority (LSA) when a logon application with a trusted connection to the LSA calls the LsaCallAuthenticationPackage function and specifies the authentication package's identifier.
LSA_AP_CALL_PACKAGE
LSA_AP_CALL_PACKAGE callback
LsaApCallPackage
LsaApCallPackage callback function [Security]
_lsa_lsaapcallpackage
ntsecpkg/LsaApCallPackage
security.lsaapcallpackage
security\lsaapcallpackage.htm
security
be0f9886-c0f6-4361-96c7-d16da8713fc7
12/05/2018
LSA_AP_CALL_PACKAGE, LSA_AP_CALL_PACKAGE callback, LsaApCallPackage, LsaApCallPackage callback function [Security], _lsa_lsaapcallpackage, ntsecpkg/LsaApCallPackage, security.lsaapcallpackage
ntsecpkg.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
LSA_AP_CALL_PACKAGE
ntsecpkg/LSA_AP_CALL_PACKAGE
c++
APIRef
kbSyntax
UserDefined
Ntsecpkg.h
LsaApCallPackage

LSA_AP_CALL_PACKAGE callback function

-description

Called by the Local Security Authority (LSA) when a logon application with a trusted connection to the LSA calls the LsaCallAuthenticationPackage function and specifies the authentication package's identifier.

LsaApCallPackage is called for logon applications only; calls from applications that do not have the SeTcbPrivilege privilege are routed to the specified authentication package's LsaApCallPackageUntrusted function instead.

-parameters

-param ClientRequest [in]

Pointer to an opaque LSA_CLIENT_REQUEST buffer representing the LSA client's request.

-param ProtocolSubmitBuffer [in]

Supplies a protocol message specific to the authentication package.

-param ClientBufferBase [in]

Provides the address within the client process of the protocol message. This may be necessary to remap any pointers within the ProtocolSubmitBuffer buffer.

-param SubmitBufferLength [in]

Specifies the length of the ProtocolSubmitBuffer buffer, in bytes.

-param ProtocolReturnBuffer [out]

Returns the address of the output buffer within the client process. The authentication package is responsible for calling the AllocateClientBuffer function to allocate the buffer within the client process. The contents of this buffer are specific to the authentication package.

-param ReturnBufferLength [out]

Pointer to a ULONG that returns the length of the ProtocolReturnBuffer buffer, in bytes.

-param ProtocolStatus [out]

Pointer to an NTSTATUS value. If the function returns STATUS_SUCCESS, ProtocolStatus returns a completion status set by the authentication package. ProtocolStatus values are specific to the authentication package.

More information about NTSTATUS codes can be found in the Subauth.h file shipped with the Platform SDK.

-returns

If the function succeeds, return STATUS_SUCCESS. This return value indicates that the authentication package attempted to provide the requested service. Use the ProtocolStatus parameter to return the completion status of the service request.

If the authentication package could not process the request and therefore did not attempt to provide the requested service, return an NTSTATUS code indicating the problem. This code can be the following value or one of the LSA Policy Function Return Values.

Return code Description
STATUS_NO_MEMORY
The client's memory quota is insufficient to allocate the output buffer.

-remarks

This function must be implemented by authentication packages.

-see-also

AllocateClientBuffer

LsaApCallPackageUntrusted

LsaCallAuthenticationPackage