ICredentialProviderFilter::Metode filter (credentialprovider.h)

Mengevaluasi apakah daftar penyedia kredensial harus diizinkan untuk memberikan petak peta kredensial.

Sintaks

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

Parameter

[in] cpus

Jenis: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Penunjuk ke nilai CREDENTIAL_PROVIDER_USAGE_SCENARIO yang menyatakan skenario di mana penyedia kredensial didukung.

[in] dwFlags

Jenis: DWORD

Bendera skenario penggunaan. Parameter ini hanya valid jika cpus CPUS_CREDUI. Mereka didefinisikan dalam Wincred.h.

CREDUIWIN_GENERIC

Nama pengguna/kata sandi teks biasa sedang diminta.

CREDUIWIN_CHECKBOX

Perlihatkan kotak centang Simpan Kredensial .

CREDUIWIN_AUTHPACKAGE_ONLY

Hanya penyedia kredensial yang mendukung paket autentikasi input yang harus menghitung.

CREDUIWIN_IN_CRED_ONLY

Hanya kredensial masuk untuk paket autentikasi tertentu yang harus dijumlahkan.

CREDUIWIN_ENUMERATE_ADMINS

Penyedia kredensial harus menghitung administrator.

CREDUIWIN_ENUMERATE_CURRENT_USER

Hanya kredensial masuk

CREDUIWIN_PACK_32_WOW

[in] rgclsidProviders

Jenis: GUID*

Penunjuk ke array PENYEDIA kredensial CLSID.

[in, out] rgbAllow

Jenis: BOOL*

Pada entri, penunjuk ke array nilai BOOL , satu untuk setiap anggota array rgclsidProviders yang sesuai, semuanya diinisialisasi ke TRUE.

Saat keluar, berisi TRUE jika penyedia kredensial yang sesuai di rgclsidProviders diizinkan untuk memberikan petak peta kredensial; jika tidak, FALSE.

[in] cProviders

Jenis: DWORD

Jumlah anggota dalam rgbAllow atau rgclsidProviders (mereka harus sama).

Mengembalikan nilai

Jenis: HRESULT

Selalu mengembalikan S_OK.

Keterangan

Pada entri, metode ini menerima dua array paralel; rgclsidProviders, yang berisi PENYEDIA kredensial CLSID dan rgbAllow, yang berisi nilai BOOL untuk CLSID yang sesuai. ICredentialProviderFilter::Filter melihat setiap penyedia kredensial di rgclsidProviders dan memutuskan apakah penyedia kredensial harus diizinkan untuk menghitung petak peta kredensial untuk skenario yang ditentukan oleh dwFlags. Jika ini dapat diterima, entri yang sesuai di rgbAllow diatur ke TRUE. Jika ini tidak dapat diterima, ini diatur ke FALSE.

Jangan pernah memfilter CLSID untuk penyedia kredensial yang tidak Anda ketahui.

Jangan memfilter jika cpus CPUS_CREDUI dan nilai dwFlags CREDUIWIN_GENERIC diteruskan.

Sah untuk mengembalikan keberhasilan dari metode dan tidak memodifikasi rgbAllow.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	credentialprovider.h