VerifySignature
This function verifies the signature of a message at the other end.
SECURITY_STATUS VerifySignature(
PCtxtHandle phContext,
PSecBufferDesc pMessage,
ULONG MessageSeqNo,
PULONG pfQOP );
Parameters
- phContext
[in] Pointer to the handle to the context to use for the message. - pMessage
[in] Pointer to a SecBufferDesc structure that references a set of SecBuffer structures that contain the message and signature to verify. The signature is in a SecBuffer structure of type SECBUFFER_TOKEN. - MessageSeqNo
[in] Specifies the sequence number expected by the transport application, if any. If the transport application does not maintain sequence numbers, this parameter is zero. - pfQOP
[out] Pointer to a ULONG variable that receives package-specific flags that indicate the quality of protection.
Return Values
SEC_E_OK indicates that the function verified that the message was received in the correct sequence and had not been modified.
If the function determines that the message is not correct according to the information in the signature, one of the error values described in the following table is returned.
| Value | Description |
|---|---|
| SEC_E_OUT_OF_SEQUENCE | The message was not received in the correct sequence. |
| SEC_E_MESSAGE_ALTERED | The message has been altered. |
Remarks
The VerifySignature function verifies that the message received was correct according to the information in the signature.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.10 and later | Sspi.h | Security.h | Schannel.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
MakeSignature, SecBuffer, SecBufferDesc
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.