通过

CredFindBestCredentialA 函数 （wincred.h）

  • 项目

CredFindBestCredential 函数在 凭据管理（CredMan）数据库中搜索与当前登录会话关联的一组通用凭据，并且与指定的目标资源最匹配。

语法

BOOL CredFindBestCredentialA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

参数

[in] TargetName

指向以 null 结尾的字符串的指针，该字符串包含要查找其凭据的目标资源的名称。

[in] Type

要搜索的凭据类型。 目前，此函数仅支持 CRED_TYPE_GENERIC。

[in] Flags

保留。

[out] Credential

指向 CREDENTIAL 结构的指针的地址，该结构指定此函数查找的凭据集。

使用此结构后，通过调用 CredFree 函数来释放它。

返回值

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

如果该函数失败，则返回 FALSE。 若要获取扩展的错误信息，请调用 GetLastError。

言论

注意

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

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 wincred.h
库 Advapi32.lib
DLL Advapi32.dll