Skip to content

Latest commit

 

History

History
135 lines (94 loc) · 4 KB

nc-ntsecpkg-kspverifysignaturefn.md

File metadata and controls

135 lines (94 loc) · 4 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.KspVerifySignatureFn
KspVerifySignatureFn (ntsecpkg.h)
Verifies that the message received is correct according to the signature.
KspVerifySignatureFn
KspVerifySignatureFn callback
SpVerifySignature
SpVerifySignature callback function [Security]
_ssp_spverifysignature
ntsecpkg/SpVerifySignature
security.spverifysignature
security\spverifysignature.htm
security
62a74a1d-c7e6-4722-af57-997a5ff553ee
12/05/2018
KspVerifySignatureFn, KspVerifySignatureFn callback, SpVerifySignature, SpVerifySignature callback function [Security], _ssp_spverifysignature, ntsecpkg/SpVerifySignature, security.spverifysignature
ntsecpkg.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
KspVerifySignatureFn
ntsecpkg/KspVerifySignatureFn
c++
APIRef
kbSyntax
UserDefined
Ntsecpkg.h
SpVerifySignature

KspVerifySignatureFn callback function

-description

Verifies that the message received is correct according to the signature.

The SpVerifySignature function is the dispatch function for the VerifySignature function of the Security Support Provider Interface.

-parameters

-param [in]

A handle to the security context used to sign the message.

-param Message [in]

Pointer to a SecBufferDesc structure containing the message to verify.

-param MessageSeqNo [in]

Sequence number to assign to the message. Sequence numbers are optional and are used as protection against loss and insertion of messages. A value of zero indicates that sequence numbers are not in use.

-param pfQOP [out]

Pointer to package-specific flags that indicate the quality of protection.

-returns

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed. The following table lists a common reason for failure and the error code that the function should return.

Return code Description
SEC_E_INVALID_HANDLE
The handle is not valid.

-remarks

The signature verified by the SpVerifySignature function is created by the SpMakeSignature function, used by a message sender.

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

A pointer to the SpVerifySignature function is available in the SECPKG_USER_FUNCTION_TABLE structure received from the SpUserModeInitialize function.

-see-also

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature