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


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

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

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

Синтаксис

CREDUIAPI DWORD CredUIConfirmCredentialsA(
  [in] PCSTR pszTargetName,
  [in] BOOL  bConfirm
);

Параметры

[in] pszTargetName

Указатель на строку, завершающуюся пустым значением, которая содержит имя целевого объекта для учетных данных, обычно это имя домена или серверного приложения. Это должно быть то же значение, что и pszTargetName в CredUIPromptForCredentials или CredUICmdLinePromptForCredentials.

[in] bConfirm

Указывает, являются ли учетные данные, возвращенные функцией prompt, допустимыми. Если задано значение TRUE, учетные данные хранятся в диспетчере учетных данных в соответствии с определением CredUIPromptForCredentials или CredUICmdLinePromptForCredentials. Если значение FALSE, учетные данные не сохраняются, а различные фрагменты памяти очищаются.

Возвращаемое значение

Возвращается состояние операции. Вызывающий объект может проверка это состояние, чтобы определить, успешно ли выполнена операция подтверждения учетных данных. Большинство приложений игнорируют этот код состояния, так как подключение приложения к ресурсу уже выполнено. Операция может завершиться ошибкой, так как учетные данные не найдены в списке учетных данных, ожидающих подтверждения, или из-за неудачной попытки записи или удаления учетных данных. Невозможность найти учетные данные в списке может быть вызвана тем, что учетные данные никогда не были поставлены в очередь или в результате слишком большого количества учетных данных в очереди. До пяти учетных данных можно поместить в очередь, прежде чем старые учетные данные будут удалены, так как новые учетные данные помещаются в очередь.

Код возврата Описание
NO_ERROR — (ноль)
Подтвердите успешное выполнение операции.
ERROR_NOT_FOUND
Не удалось найти учетные данные субъекта в списке ожидания подтверждения.
ERROR_INVALID_PARAMETER
Попытка подтвердить учетные данные ожидания завершилась сбоем, так как учетные данные содержали недопустимые или несогласованные данные.

Комментарии

Примечание

Заголовок wincred.h определяет CredUIConfirmCredentials в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wincred.h
Библиотека Credui.lib
DLL Credui.dll