CredEnumerateA 函数（wincred.h）

CredEnumerate 函数枚举用户凭据集中的凭据。使用的凭据集是与当前令牌的登录会话关联的凭据集。令牌不得禁用用户的 SID。

语法

BOOL CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **Credential
);

[in] Filter

指向包含返回凭据筛选器的 null终止字符串的指针。仅返回 TargetName 与筛选器匹配的凭据。筛选器指定名称前缀，后跟星号。例如，筛选器“FRED*”将返回所有凭据，其 TargetName 以字符串“FRED”开头。

如果指定 NULL，将返回所有凭据。

[in] Flags

此参数的值可以是以下值中的零个或多个，与按位OR 运算结合使用。

价值	意义
CRED_ENUMERATE_ALL_CREDENTIALS 0x1	此函数枚举用户凭据集中的所有凭据。每个凭据的目标名称以“namespace：attribute=target”格式返回。如果设置了此标志，并且 Filter 参数未 NULL，则该函数将失败并返回 ERROR_INVALID_FLAGS。 Windows Server 2003 和 Windows XP：不支持此标志。

[out] Count

凭据数组中返回的凭据计数。

[out] Credential

指向指向凭据的指针数组的指针。返回的凭据是单个分配的块。缓冲区中包含的任何指针都是指向此单个分配块内的位置的指针。必须通过调用 credFree调用释放单个返回的缓冲区。

该函数返回成功 TRUE，并在失败时 FALSE。可以调用 GetLastError 函数以获取更具体的状态代码。可以返回以下状态代码。

返回代码/值	描述
ERROR_NOT_FOUND 1168 （0x490）	不存在与指定筛选器匹配的凭据。
ERROR_NO_SUCH_LOGON_SESSION 1312 （0x520）	登录会话不存在，或者没有与此登录会话关联的凭据集。网络登录会话没有关联的凭据集。
ERROR_INVALID_FLAGS 1004 （0x3EC）	为标志参数指定无效的标志，或者为标志参数指定 CRED_ENUMERATE_ALL_CREDENTIALS，并且 Filter 参数未 NULL。

注意

wincred.h 标头将 CredEnumerate 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。