SpInitUserModeContextFn 回调函数 (ntsecpkg.h)

  • 项目

SpInitUserModeContext 函数从打包的本地安全机构 ( LSA) 模式上下文创建用户模式安全上下文。

语法

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

参数

[in] ContextHandle

从 SpInitLsaModeContext 或 SpAcceptLsaModeContext 函数返回的 LSA 模式上下文的 句柄。

[in] PackedContext

指向包含序列化上下文数据的 SecBuffer 结构的指针。 使用 FreeContextBuffer 函数释放为此结构分配的内存。

返回值

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

如果函数失败，则返回一个 NTSTATUS 代码，用于指示它失败的原因。 下面列出了失败的常见原因以及函数应返回的错误代码。

返回代码 说明
STATUS_INSUFFICIENT_RESOURCES
 内存不足，无法创建上下文。

注解

如果 SpInitLsaModeContext 或 SpAcceptLsaModeContext 的 MappedContext 参数设置为 TRUE，则会在安全包创建安全上下文后调用 SpInitUserModeContext 函数。 包特定的上下文数据应包含确定哪个函数导致调用 SpInitUserModeContext 所需的信息。

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

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

要求

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

另请参阅

SECPKG_USER_FUNCTION_TABLE

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize