SpQueryContextAttributesFn 回调函数 (ntsecpkg.h)

  • 项目

SpQueryContextAttributes 函数检索安全上下文的属性。

SpQueryContextAttributes 函数是 Security Support Provider Interface 的 QueryContextAttributes (General) 函数的调度函数。

语法

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

参数

[in] ContextHandle

安全上下文的句柄。

[in] ContextAttribute

要查询的上下文属性。 有关有效值的列表，请参阅 QueryContextAttributes (General) 函数。

[out] Buffer

接收包含所请求属性的缓冲区地址的指针。 Buffer 参数的内存应通过用户模式下的 SECPKG_DLL_FUNCTIONS 函数表中的 AllocateHeap 函数进行分配。 在本地 安全机构 (LSA) 模式下，使用 AllocateLsaHeap 函数。

返回值

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

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

返回代码 说明
SEC_E_INVALID_HANDLE
 句柄无效。

注解

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

从 SpLsaModeInitialize 函数接收的 SECPKG_FUNCTION_TABLE 结构中提供了指向 SpQueryContextAttributes 函数的 LSA 模式实现的指针。

指向 SpQueryContextAttributes 函数的用户模式实现的指针在从 SpUserModeInitialize 函数接收的 SECPKG_USER_FUNCTION_TABLE 结构中可用。

要求

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

另请参阅

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize