LSA_CALL_PACKAGE_PASSTHROUGH callback function (ntsecpkg.h)
The CallPackagePassthrough function is used to call another security package to access its services.
Syntax
LSA_CALL_PACKAGE_PASSTHROUGH LsaCallPackagePassthrough;
NTSTATUS LsaCallPackagePassthrough(
[in] PUNICODE_STRING AuthenticationPackage,
[in] PVOID ClientBufferBase,
[in] PVOID ProtocolSubmitBuffer,
[in] ULONG SubmitBufferLength,
[out] PVOID *ProtocolReturnBuffer,
[out] PULONG ReturnBufferLength,
[out] PNTSTATUS ProtocolStatus
)
{...}
Parameters
[in] AuthenticationPackage
Pointer to a UNICODE_STRING containing the name of the package to call.
[in] ClientBufferBase
The base address of the input buffer, in the client's address space.
[in] ProtocolSubmitBuffer
Pointer to the input buffer.
[in] SubmitBufferLength
Size of the ProtocolSubmitBuffer parameter in bytes.
[out] ProtocolReturnBuffer
Pointer to the output buffer.
[out] ReturnBufferLength
Pointer to a variable that receives the size of the ProtocolReturnBuffer parameter in bytes.
[out] ProtocolStatus
Pointer to a variable that receives the status code returned by the package.
Return value
If the function succeeds, the return value is STATUS_SUCCESS.
If the function fails, the return value is an NTSTATUS code indicating the reason it failed. The following table lists a common reason for failure and the error code that the function returns.
| Return code | Description |
|---|---|
|
The AuthenticationPackage parameter does not contain the name of a valid SSP/AP. |
Remarks
The Local Security Authority (LSA) does not examine or alter any of the function arguments.
A pointer to the CallPackagePassthrough function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.
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 |