Функция CredUIConfirmCredentialsA (wincred.h)

Статья
11/20/2024

Функция CredUIConfirmCredentials вызывается после CredUIPromptForCredentials или CredUICmdLinePromptForCredentials, чтобы подтвердить правильность собранных учетных данных. CredUIConfirmCredentials необходимо вызвать, если флаг CREDUI_FLAGS_EXPECT_CONFIRMATION был передан в функцию "запрос", либо CredUIPromptForCredentials или CredUICmdLinePromptForCredentials, а функция "запрос" возвращает NO_ERROR.

После вызова функции "запрос" и перед вызовом CredUIConfirmCredentialsвызывающий объект должен определить, действительны ли учетные данные с помощью учетных данных для доступа к ресурсу, указанному pszTargetName. Результаты этого теста проверки передаются CredUIConfirmCredentials в параметре bConfirm.

Синтаксис

CREDUIAPI DWORD CredUIConfirmCredentialsA(
  [in] PCSTR 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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	wincred.h
библиотеки	Credui.lib
DLL	Credui.dll

Поделиться через