SpValidateTargetInfoFn callback function (ntsecpkg.h)

Article
02/22/2024

Validates that the specified SECPKG_TARGETINFO structure represents a valid target.

Syntax

SpValidateTargetInfoFn Spvalidatetargetinfofn;

NTSTATUS Spvalidatetargetinfofn(
  [in, optional] PLSA_CLIENT_REQUEST ClientRequest,
  [in]           PVOID ProtocolSubmitBuffer,
  [in]           PVOID ClientBufferBase,
  [in]           ULONG SubmitBufferLength,
  [in]           PSECPKG_TARGETINFO TargetInfo
)
{...}

Parameters

[in, optional] ClientRequest

A pointer to an opaque LSA_CLIENT_REQUEST data structure that contains information about the LSA client's authentication request. A custom authentication package should pass in the value received during the client's call to the function, such as LsaApCallPackage or LsaApLogonUser, that returns the output parameter.

[in] ProtocolSubmitBuffer

A pointer to the input buffer sent by the client.

[in] ClientBufferBase

The base address of the input buffer, in the client's address space.

[in] SubmitBufferLength

The size, in bytes, of the ProtocolSubmitBuffer buffer.

[in] TargetInfo

A pointer to a SECPKG_TARGETINFO structure that specifies the target to validate.

Return value

If the function succeeds and the specified target is a valid target, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Remarks

SSP/APs must implement the SpValidateTargetInfo function; however, the actual name given to the implementation is up to the developer.

A pointer to the SpValidateTargetInfo function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	ntsecpkg.h