ICredentialProviderFilter::Filter-Methode (credentialprovider.h)

Artikel
08/22/2023

Wertet aus, ob eine Liste von Anmeldeinformationsanbietern zum Bereitstellen von Anmeldeinformationskacheln zugelassen werden soll.

Syntax

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

Parameter

[in] cpus

Typ: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Ein Zeiger auf einen CREDENTIAL_PROVIDER_USAGE_SCENARIO Wert, der die Szenarien deklariert, in denen ein Anmeldeinformationsanbieter unterstützt wird.

[in] dwFlags

Art: DWORD

Verwendungsszenarioflags. Dieser Parameter ist nur gültig, wenn cpus CPUS_CREDUI ist. Sie sind in Wincred.h definiert.

CREDUIWIN_GENERIC

Benutzername/Kennwort für Nur-Text wird angefordert.

CREDUIWIN_CHECKBOX

Zeigen Sie das Kontrollkästchen Anmeldeinformationen speichern an.

CREDUIWIN_AUTHPACKAGE_ONLY

Nur Anmeldeinformationsanbieter, die das Eingabeauthentifizierungspaket unterstützen, sollten aufgelistet werden.

CREDUIWIN_IN_CRED_ONLY

Nur die eingehenden Anmeldeinformationen für das spezifische Authentifizierungspaket sollten aufgezählt werden.

CREDUIWIN_ENUMERATE_ADMINS

Anmeldeinformationsanbieter sollten Administratoren auflisten.

CREDUIWIN_ENUMERATE_CURRENT_USER

Nur die eingehenden Anmeldeinformationen

CREDUIWIN_PACK_32_WOW

[in] rgclsidProviders

Typ: GUID*

Ein Zeiger auf ein Array von Anmeldeinformationsanbieter-CLSIDs.

[in, out] rgbAllow

Typ: BOOL*

Beim Einstieg ein Zeiger auf ein Array von BOOL-Werten , eins für jeden entsprechenden Member des rgclsidProviders-Arrays , der alle auf TRUE initialisiert wird.

Beim Beenden enthält TRUE , wenn der entsprechende Anmeldeinformationsanbieter in rgclsidProviders eine Kachel für Anmeldeinformationen bereitstellen darf. andernfalls FALSE.

[in] cProviders

Art: DWORD

Die Anzahl der Member in rgbAllow oder rgclsidProviders (sie sollten identisch sein).

Rückgabewert

Typ: HRESULT

Gibt immer S_OK zurück.

Hinweise

Beim Einstieg empfängt diese Methode zwei parallele Arrays; rgclsidProviders, das die Anmeldeinformationsanbieter-CLSIDs und rgbAllow enthält, die BOOL-Werte für die entsprechenden CLSIDs enthält. ICredentialProviderFilter::Filter untersucht jeden Anmeldeinformationsanbieter in rgclsidProviders und entscheidet, ob der Anmeldeinformationsanbieter kacheln für das von dwFlags angegebene Szenario aufzählen darf. Wenn dies akzeptabel ist, wird der entsprechende Eintrag in rgbAllow auf TRUE festgelegt. Wenn dies inakzeptabel ist, wird sie auf FALSE festgelegt.

Filtern Sie niemals eine CLSID nach einem Anmeldeinformationsanbieter, den Sie nicht kennen.

Filtern Sie nicht, ob cpus CPUS_CREDUI und der dwFlags-Wert CREDUIWIN_GENERIC übergeben wird.

Es ist legitim, den Erfolg der Methode zurückzugeben und rgbAllow nicht zu ändern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	credentialprovider.h

Freigeben über