SpUnsealMessageFn 回调函数 (ntsecpkg.h)

解密以前使用 SpSealMessage 函数加密的消息。

SpUnsealMessage 函数是安全支持提供程序接口DecryptMessage (General) 函数的调度函数。

语法

SpUnsealMessageFn Spunsealmessagefn;

NTSTATUS Spunsealmessagefn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  PSecBufferDesc MessageBuffers,
  [in]  ULONG MessageSequenceNumber,
  [out] PULONG QualityOfProtection
)
{...}

参数

[in] ContextHandle

用于密封消息 的安全上下文 的句柄。

[in] MessageBuffers

指向包含消息缓冲区和签名缓冲区的 SecBufferDesc 结构的指针。

[in] MessageSequenceNumber

要分配给消息的序列号。 序列号是可选的,用作防止消息丢失和插入的保护。 值为零表示序列号未使用。

[out] QualityOfProtection

未使用。

返回值

如果函数成功,则返回STATUS_SUCCESS。

如果函数失败,则返回一个 NTSTATUS 代码,指示它失败的原因。

注解

SSP/AP 必须实现 SpUnsealMessage 函数;但是,为实现提供的实际名称由开发人员决定。

SpUserModeInitialize 函数接收的 SECPKG_USER_FUNCTION_TABLE 结构中提供了指向 SpUnsealMessage 函数的指针。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecpkg.h

另请参阅

DecryptMessage (常规)

SECPKG_USER_FUNCTION_TABLE

SpSealMessage

SpUserModeInitialize