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

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

반환 값

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

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

발언

요구 사항