SspiPromptForCredentialsA 함수(sspi.h)

  • 아티클

SSPI( 보안 지원 공급자 인터페이스 ) 애플리케이션에서 사용자에게 자격 증명을 입력하라는 메시지를 표시할 수 있습니다.

구문

unsigned long SEC_ENTRY SspiPromptForCredentialsA(
  [in]                PCSTR                           pszTargetName,
  [in]                PCREDUI_INFOA                   pUiInfo,
  [in]                unsigned long                   dwAuthError,
  [in]                PCSTR                           pszPackage,
  [in]                PSEC_WINNT_AUTH_IDENTITY_OPAQUE pInputAuthIdentity,
  [out]               PSEC_WINNT_AUTH_IDENTITY_OPAQUE *ppAuthIdentity,
  [in, out, optional] int                             *pfSave,
  [in]                unsigned long                   dwFlags
);

매개 변수

[in] pszTargetName

사용할 대상의 이름입니다.

[in] pUiInfo

이 함수가 표시하는 대화 상자의 모양을 사용자 지정하기 위한 정보가 포함된 CREDUI_INFO 구조체에 대한 포인터입니다.

CREDUI_INFO 구조체의 hwndParent 멤버가 NULL이 아닌 경우 이 함수는 부모 창 가운데에 모달 대화 상자를 표시합니다.

CREDUI_INFO 구조체의 hwndParent 멤버가 NULL이면 함수는 화면 가운데에 대화 상자를 표시합니다.

이 함수는 CREDUI_INFO 구조체의 hbmBanner 멤버를 무시합니다.

[in] dwAuthError

대화 상자에 표시되는 Winerror.h에 정의된 Windows 오류 코드입니다. 이전에 수집한 자격 증명이 유효하지 않은 경우 호출자는 이 매개 변수를 사용하여 자격 증명(예: Winlogon)을 수집한 API의 오류 메시지를 이 함수에 전달합니다. 해당 오류 메시지의 서식이 지정되어 대화 상자에 표시됩니다. 이 매개 변수의 값을 0으로 설정하여 오류 메시지를 표시하지 않습니다.

[in] pszPackage

사용할 보안 패키지의 이름입니다.

[in] pInputAuthIdentity

대화 상자에서 자격 증명 필드를 채우는 데 사용되는 ID 구조입니다. 자격 증명 필드를 비워 두려면 이 매개 변수의 값을 NULL로 설정합니다.

[out] ppAuthIdentity

이 함수가 수집하는 자격 증명을 나타내는 ID 구조입니다.

이 구조체 사용을 마치면 SspiFreeAuthIdentity 함수를 호출하여 해제합니다.

[in, out, optional] pfSave

입력에서 이 함수가 표시하는 대화 상자에서 검사 저장 상자를 선택할지 여부를 지정하는 부울 값에 대한 포인터입니다. 출력에서 이 매개 변수의 값은 사용자가 대화 상자에서 제출 단추를 클릭할 때 검사 저장 상자를 선택했는지 여부를 지정합니다. 저장 검사 상자를 무시하려면 이 매개 변수를 NULL로 설정합니다.

CREDUIWIN_CHECKBOX 플래그가 dwFlags 매개 변수에 설정되지 않은 경우 이 매개 변수는 무시됩니다.

[in] dwFlags

이 함수의 동작을 결정하는 플래그입니다. 현재 다음 플래그가 정의되어 있습니다.

값 의미
SSPIPFC_CREDPROV_DO_NOT_SAVE
0x00000001
 pfSave 매개 변수의 값은 무시되며 이 함수에서 수집한 자격 증명은 저장되지 않습니다.

Windows 7 및 Windows Server 2008 R2: pfSave 매개 변수의 값은 무시되며 이 함수에서 수집한 자격 증명은 저장되지 않습니다. 이 가능한 값의 이름만 SSPIPFC_SAVE_CRED_BY_CALLER.
SSPIPFC_NO_CHECKBOX
0x00000002
 값은 암호 및 스마트 카드 자격 증명 공급자가 사용자에게 "내 자격 증명 기억" 확인란을 표시하지 않음을 의미합니다. SspiPromptForCredentials 함수는 CredUIPromptForWindowsCredentials 함수의 pvInAuthBuffer 매개 변수에 SSPIPFC_NO_CHECKBOX 이 플래그 값을 전달합니다.

반환 값

함수가 성공하면 SEC_E_OK 반환합니다.

함수가 실패하면 0이 아닌 오류 코드가 반환됩니다.

설명

참고

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

요구 사항

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