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
要查询的属性。 下表列出了有效值。
值 | 含义 |
---|---|
|
与 凭据关联的主体的名称。 |
|
特定凭据支持的算法。 |
|
与凭据一起使用的最小和最大密码强度。 |
|
特定凭据支持的协议。 |
[out] Buffer
指向接收所请求属性的缓冲区的指针。 使用 AllocateClientBuffer 函数为此缓冲区分配内存,以便调用方可以通过调用 FreeContextBuffer 函数释放该缓冲区。
返回值
如果函数成功,则返回STATUS_SUCCESS。
如果函数失败,则返回一个 NTSTATUS 代码,用于指示它失败的原因。 下面列出了失败的常见原因以及函数应返回的错误代码。
返回代码 | 说明 |
---|---|
|
内存分配失败。 |
|
凭据句柄无效。 |
注解
SSP/AP 必须实现 SpQueryCredentialsAttributes 函数;但是,为实现提供的实际名称由开发人员决定。
从 SpLsaModeInitialize 函数接收的 SECPKG_FUNCTION_TABLE 结构中提供了指向 SpQueryCredentialsAttributes 函数的指针。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | ntsecpkg.h |