Verifies that the message received is correct according to the signature.
NTSTATUS SpVerifySignature( _In_ LSA_SEC_HANDLE ContextHandle, _In_ PSecBufferDesc MessageBuffers, _In_ ULONG MessageSequenceNumber, _Out_ PULONG QualityOfProtection );
- ContextHandle [in]
A handle to the security context used to sign the message.
- MessageBuffers [in]
Pointer to a SecBufferDesc structure containing the message to verify.
- MessageSequenceNumber [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.
- QualityOfProtection [out]
Pointer to package-specific flags that indicate the quality of protection.
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.
The handle is not valid.
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.
Minimum supported client
|Windows XP [desktop apps only]|
Minimum supported server
|Windows Server 2003 [desktop apps only]|
Build date: 1/2/2013