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 |
|
See also