SpQueryCredentialsAttributesFn 回调函数 (ntsecpkg.h)

  • 项目

SpQueryCredentialsAttributes 函数检索凭据的属性。

SpQueryCredentialsAttributes 函数是安全支持提供程序接口的 QueryCredentialsAttributes 函数的调度函数。

语法

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

参数

[in] CredentialHandle

要查询的凭据的句柄。

[in] CredentialAttribute

要查询的属性。 下表列出了有效值。

值 含义
SECPKG_CRED_ATTR_NAMES
 与 凭据关联的主体的名称。
SECPKG_ATTR_SUPPORTED_ALGS
 特定凭据支持的算法。
SECPKG_ATTR_CIPHER_STRENGTHS
 与凭据一起使用的最小和最大密码强度。
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 特定凭据支持的协议。

[out] Buffer

指向接收所请求属性的缓冲区的指针。 使用 AllocateClientBuffer 函数为此缓冲区分配内存，以便调用方可以通过调用 FreeContextBuffer 函数释放该缓冲区。

返回值

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

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

返回代码 说明
SEC_E_INSUFFICIENT_MEMORY
 内存分配失败。
SEC_E_INVALID_HANDLE
 凭据句柄无效。

注解

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

从 SpLsaModeInitialize 函数接收的 SECPKG_FUNCTION_TABLE 结构中提供了指向 SpQueryCredentialsAttributes 函数的指针。

要求

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

另请参阅

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize