ICredentialProviderFilter::Filter 메서드(credentialprovider.h)

아티클
08/22/2023

자격 증명 공급자 목록을 자격 증명 타일을 제공할 수 있는지 여부를 평가합니다.

구문

HRESULT Filter(
  [in]      CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in]      DWORD                              dwFlags,
  [in]      GUID                               *rgclsidProviders,
  [in, out] BOOL                               *rgbAllow,
  [in]      DWORD                              cProviders
);

매개 변수

[in] cpus

형식: CREDENTIAL_PROVIDER_USAGE_SCENARIO

자격 증명 공급자가 지원되는 시나리오를 선언하는 CREDENTIAL_PROVIDER_USAGE_SCENARIO 값에 대한 포인터입니다.

[in] dwFlags

형식:DWORD

사용 시나리오 플래그입니다. 이 매개 변수는 cpu가 CPUS_CREDUI 경우에만 유효합니다. Wincred.h에서 정의됩니다.

CREDUIWIN_GENERIC

일반 텍스트 사용자 이름/암호가 요청되고 있습니다.

CREDUIWIN_CHECKBOX

자격 증명 저장 확인란을 표시합니다.

CREDUIWIN_AUTHPACKAGE_ONLY

입력 인증 패키지를 지원하는 자격 증명 공급자만 열거해야 합니다.

CREDUIWIN_IN_CRED_ONLY

특정 인증 패키지에 대해 들어오는 자격 증명만 열거해야 합니다.

CREDUIWIN_ENUMERATE_ADMINS

자격 증명 공급자는 관리자를 열거해야 합니다.

CREDUIWIN_ENUMERATE_CURRENT_USER

들어오는 자격 증명만

CREDUIWIN_PACK_32_WOW

[in] rgclsidProviders

형식: GUID*

자격 증명 공급자 CLSID 배열에 대한 포인터입니다.

[in, out] rgbAllow

형식: BOOL*

항목에서 BOOL 값 배열에 대한 포인터로, rgclsidProviders 배열의 각 해당 멤버에 대해 하나씩 모두 TRUE로 초기화됩니다.

종료 시 는 rgclsidProviders의 해당 자격 증명 공급자가 자격 증명 타일을 제공할 수 있는 경우 TRUE를 포함합니다. 그렇지 않으면 FALSE입니다.

[in] cProviders

형식:DWORD

rgbAllow 또는 rgclsidProviders의 멤버 수입니다(동일해야 합니다).

반환 값

형식: HRESULT

항상 S_OK 반환합니다.

설명

항목에서 이 메서드는 두 개의 병렬 배열을 받습니다. 자격 증명 공급자 CLSID 및 해당 CLSID에 대한 BOOL 값을 포함하는 rgbAllow를 포함하는 rgclsidProviders입니다. ICredentialProviderFilter::Filter 는 rgclsidProviders 의 각 자격 증명 공급자를 살펴보고 dwFlags로 지정된 시나리오에 대해 자격 증명 공급자가 자격 증명 타일을 열거할 수 있는지 여부를 결정합니다. 허용되는 경우 rgbAllow 의 해당 항목은 TRUE로 설정됩니다. 허용되지 않는 경우 FALSE로 설정됩니다.

모르는 자격 증명 공급자에 대한 CLSID를 필터링하지 마세요.

cpu가 CPUS_CREDUI CREDUIWIN_GENERIC dwFlags 값이 전달되는지 필터링하지 마세요.

메서드에서 성공을 반환하고 rgbAllow를 수정하지 않는 것이 합법적입니다.

요구 사항

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

Share via