CredUIConfirmCredentialsA 함수(wincred.h)

CredUIConfirmCredentials 함수는 CredUIPromptForCredentials 또는 CredUICmdLinePromptForCredentials 이후에 호출되어 수집된 자격 증명의 유효성을 확인합니다. CREDUI_FLAGS_EXPECT_CONFIRMATION 플래그가 "prompt" 함수에 전달된 경우 CredUIPromptForCredentials 또는 CredUICmdLinePromptForCredentials 및 "prompt" 함수가 NO_ERROR 반환된 경우 CredUIConfirmCredentials를 호출해야 합니다.

"prompt" 함수를 호출하고 CredUIConfirmCredentials를 호출하기 전에 호출자는 자격 증명을 사용하여 pszTargetName으로 지정된 리소스에 액세스하여 자격 증명이 실제로 유효한지 여부를 결정해야 합니다. 해당 유효성 검사 테스트의 결과는 bConfirm 매개 변수의 CredUIConfirmCredentials에 전달됩니다.

구문

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

매개 변수

[in] pszTargetName

자격 증명의 대상 이름(일반적으로 도메인 또는 서버 애플리케이션 이름)이 포함된 null로 끝나는 문자열에 대한 포인터입니다. pszTargetName이 CredUIPromptForCredentials 또는 CredUICmdLinePromptForCredentials에 전달된 값과 동일해야 합니다.

[in] bConfirm

프롬프트 함수에서 반환된 자격 증명이 유효한지 여부를 지정합니다. TRUE이면 자격 증명이 CredUIPromptForCredentials 또는 CredUICmdLinePromptForCredentials에 정의된 대로 자격 증명 관리자에 저장됩니다. FALSE이면 자격 증명이 저장되지 않고 다양한 메모리 부분이 정리됩니다.

반환 값

작업의 상태가 반환됩니다. 호출자는 이 상태 검사 자격 증명 확인 작업이 성공했는지 여부를 확인할 수 있습니다. 리소스에 대한 애플리케이션의 연결이 이미 완료되었으므로 대부분의 애플리케이션은 이 상태 코드를 무시합니다. 확인을 기다리는 자격 증명 목록에서 자격 증명을 찾을 수 없거나 자격 증명을 작성하거나 삭제하지 못했기 때문에 작업이 실패할 수 있습니다. 자격 증명이 큐에 대기되지 않았거나 너무 많은 자격 증명이 큐에 대기되었기 때문에 목록에서 자격 증명을 찾지 못할 수 있습니다. 최신 자격 증명이 큐에 대기되면 이전 자격 증명을 삭제하기 전에 최대 5개의 자격 증명을 큐에 대기할 수 있습니다.

반환 코드	설명
NO_ERROR - (0)	작업이 성공했는지 확인합니다.
ERROR_NOT_FOUND	확인 대기자 목록에서 주체 자격 증명을 찾을 수 없습니다.
ERROR_INVALID_PARAMETER	자격 증명에 유효하지 않거나 일치하지 않는 데이터가 포함되어 있기 때문에 대기 중인 자격 증명을 확인하는 데 실패했습니다.

설명

참고

wincred.h 헤더는 CRedUIConfirmCredentials를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wincred.h
라이브러리	Credui.lib
DLL	Credui.dll