ICredentialProvider::SetUsageScenario 메서드(credentialprovider.h)

아티클
08/22/2023

자격 증명 공급자가 유효한 시나리오를 정의합니다. 자격 증명 공급자가 초기화될 때마다 호출됩니다.

구문

HRESULT SetUsageScenario(
  [in] CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in] DWORD                              dwFlags
);

매개 변수

[in] cpus

형식: CREDENTIAL_PROVIDER_USAGE_SCENARIO

자격 증명 공급자가 만들어진 시나리오입니다. 지원되어야 하는 사용 시나리오입니다. 자세한 내용은 비고를 참조하세요.

[in] dwFlags

형식:DWORD

자격 증명 공급자의 동작에 영향을 주는 값입니다. 이 값은 Wincred.h에 정의된 다음 값 중 하나 이상의 비트 OR 조합일 수 있습니다. 자세한 내용은 CredUIPromptForWindowsCredentials 를 참조하세요.

CREDUIWIN_GENERIC(0x00000001)

0x00000001. 호출자는 자격 증명 공급자가 사용자 이름과 암호를 일반 텍스트로 반환하도록 요청합니다. 이 값은 CREDUIWIN_SECURE_PROMPT 결합할 수 없습니다.

CREDUIWIN_CHECKBOX(0x00000002)

0x00000002. 검사 저장 상자가 대화 상자에 표시됩니다.

CREDUIWIN_AUTHPACKAGE_ONLY(0x00000010)

0x00000010. 입력 인증 패키지를 지원하는 자격 증명 공급자만 열거해야 합니다. 자격 증명 공급자가 입력 인증 패키지를 지원하지 않는 경우 사용자 타일 0을 열거해야 합니다. 이 값은 CREDUIWIN_IN_CRED_ONLY 함께 사용할 수 없습니다.

CREDUIWIN_IN_CRED_ONLY(0x00000020)

0x00000020. 공급자가 자격 증명을 직렬화할 수 있는 경우 해당 자격 증명에 대한 타일을 열거해야 합니다. 다른 타일은 열거해서는 안 됩니다. 자격 증명 공급자는 ICredentialProvider::SetSerialization 및 ICredentialProvider::SetUsageScenario의 입력CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 사용하여 열거할 자격 증명 타일 수를 결정해야 합니다. 이 값은 CREDUIWIN_AUTHPACKAGE_ONLY 결합할 수 없습니다.

CREDUIWIN_ENUMERATE_ADMINS(0x00000100)

0x00000100. 자격 증명 공급자는 관리자만 열거해야 합니다. 이 값은 UAC 용도로만 사용됩니다. 외부 호출자는 이 플래그를 설정하지 않는 것이 좋습니다.

CREDUIWIN_ENUMERATE_CURRENT_USER(0x00000200)

0x00000200. 자격 증명 공급자는 현재 로그온한 사용자의 타일을 열거해야 합니다.

CREDUIWIN_SECURE_PROMPT(0x00001000)

0x00001000. 자격 증명 대화 상자는 보안 데스크톱에 표시되어야 합니다. 이 값은 CREDUIWIN_GENERIC 결합할 수 없습니다. 자격 증명 공급자 구현자는 이 플래그를 안전하게 무시할 수 있습니다.

CREDUIWIN_PACK_32_WOW(0x10000000)

0x10000000. 공급자에게 전달되는 버퍼는 32비트입니다. 공급자에서 반환된 버퍼도 32비트여야 합니다. WOW64에 필요합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 필수이며 자격 증명 공급자가 사용 방법을 나타낼 수 있도록 합니다.

이 메서드는 호출이 완료되었지만 요청된 사용 시나리오가 지원되지 않는 경우 E_NOTIMPL 반환해야 합니다. 메서드가 성공하고 사용 시나리오가 지원되는 경우 이 메서드는 S_OK 반환해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	credentialprovider.h

다음을 통해 공유