通过

CredUIConfirmCredentialsW 函数 （wincred.h）

  • 项目

CredUIConfirmCredentials 函数在 CredUIPromptForCredentials 或 CredUICmdLinePromptForCredentials后调用，以确认已获取凭据的有效性。 如果 CREDUI_FLAGS_EXPECT_CONFIRMATION标志传递到“prompt”函数（CredUIPromptForCredentials 或 CredUICmdLinePromptForCredentials，CredUICmdLinePromptForCredentials，并且 NO_ERROR返回了“prompt”函数，则必须调用 credUIConfirmCredentials。

在调用“prompt”函数并在调用 CredUIConfirmCredentials之前，调用方必须通过使用凭据来访问 pszTargetName指定的资源，来确定凭据是否实际有效。 验证测试的结果将传递给 bConfirm 参数中的 CredUIConfirmCredentials。

语法

CREDUIAPI DWORD CredUIConfirmCredentialsW(
  [in] PCWSTR pszTargetName,
  [in] BOOL   bConfirm
);

参数

[in] pszTargetName

指向 null-terminated 字符串的指针，该字符串包含凭据的目标名称（通常是域或服务器应用程序名称）。 此值必须与 pszTargetName 传递到 CredUIPromptForCredentials 或 CredUICmdLinePromptForCredentials

[in] bConfirm

指定从提示函数返回的凭据是否有效。 如果 TRUE，则凭据存储在凭据管理器中，由 CredUIPromptForCredentials 或 CredUICmdLinePromptForCredentials。 如果 FALSE，则不会存储凭据，并清理各种内存片段。

返回值

返回操作的状态。 调用方可以检查此状态，以确定凭据确认操作是否成功。 大多数应用程序会忽略此状态代码，因为应用程序已连接到资源。 操作可能会失败，因为凭据未在等待确认的凭据列表中找到，或者尝试写入或删除凭据失败。 由于凭据从未排队或由于排队的凭据过多，因此无法找到列表中的凭据。 在旧凭据被丢弃之前，最多可以排队五个凭据，因为较新的凭据已排队。

返回代码 描述
NO_ERROR - （零）
 确认操作成功。
ERROR_NOT_FOUND
 在确认等待列表中找不到主题凭据。
ERROR_INVALID_PARAMETER
 尝试确认等待的凭据失败，因为凭据包含无效或不一致的数据。

言论

注意

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

要求

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