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 [仅限桌面应用]
目标平台	Windows
标头	wincred.h
Library	Advapi32.lib
DLL	Advapi32.dll