Share via


SealMessage

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function seals a message.

Syntax

SECURITY_STATUS SEC_ENTRY SealMessage( 
  PCtxtHandle phContext,
  ULONG fQOP 
  PSecBufferDesc pMessage, 
  ULONG MessageSeqNo, 
);

Parameters

  • phContext
    [in] Pointer to a CtxtHandle structure identifying the context handle. For information on CtxtHandle, see SSPI Handles.
  • fQOP
    [in] Package-specific flags that indicate the quality of protection.
  • pMessage
    [in, out] Pointer to a SecBufferDesc structure that references a set of SecBuffer structures that contains the message to seal.
  • MessageSeqNo
    [in] The message sequence number expected by the transport application, if any. If the transport application does not maintain sequence numbers, this parameter is zero.

Return Value

This function returns SEC_E_OK to indicate that it 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, it returns one of the error values described in the following table.

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.

Requirements

Header sspi.h
Library secur32.lib
Windows Embedded CE Windows CE 2.10 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

SecBuffer
SecBufferDesc
UnsealMessage