Export (0) Print
Expand All
Expand Minimize

SpUnsealMessage function

Decrypts a message that was previously encrypted with the SpSealMessage function.

The SpUnsealMessage function is the dispatch function for the DecryptMessage (General) function of the Security Support Provider Interface.

Syntax


NTSTATUS SpUnsealMessage(
  _In_   LSA_SEC_HANDLE ContextHandle,
  _In_   PSecBufferDesc MessageBuffers,
  _In_   ULONG MessageSequenceNumber,
  _Out_  PULONG QualityOfProtection
);

Parameters

ContextHandle [in]

Handle of the security context used to seal the message.

MessageBuffers [in]

Pointer to a SecBufferDesc structure that contains the message buffers and a signature buffer.

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]

Not used.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Remarks

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

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

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

DecryptMessage (General)
SECPKG_USER_FUNCTION_TABLE
SpSealMessage
SpUserModeInitialize

 

 

Community Additions

ADD
Show:
© 2014 Microsoft