SpValidateTargetInfoFn function

Validates that the specified SECPKG_TARGETINFO structure represents a valid target.


NTSTATUS WINAPI SpValidateTargetInfoFn(
  _In_opt_ PLSA_CLIENT_REQUEST ClientRequest,
  _In_     PVOID               ProtocolSubmitBuffer,
  _In_     PVOID               ClientBufferBase,
  _In_     ULONG               SubmitBufferLength,
  _In_     PSECPKG_TARGETINFO  TargetInfo


ClientRequest [in, optional]

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.

ProtocolSubmitBuffer [in]

A pointer to the input buffer sent by the client.

ClientBufferBase [in]

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

SubmitBufferLength [in]

The size, in bytes, of the ProtocolSubmitBuffer buffer.

TargetInfo [in]

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.


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.


Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]



See also