Metodo ICredentialProviderFilter::Filter (credentialprovider.h)

Articolo
08/22/2023

Valuta se un elenco di provider di credenziali deve essere autorizzato a fornire riquadri delle credenziali.

Sintassi

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

Parametri

[in] cpus

Tipo: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Puntatore a un valore CREDENTIAL_PROVIDER_USAGE_SCENARIO che dichiara gli scenari in cui è supportato un provider di credenziali.

[in] dwFlags

Tipo: DWORD

Flag di scenario di utilizzo. Questo parametro è valido solo se le CPU sono CPUS_CREDUI. Sono definiti in Wincred.h.

CREDUIWIN_GENERIC

Viene richiesto il nome utente/la password di testo normale.

CREDUIWIN_CHECKBOX

Mostra la casella di controllo Salva credenziali .

CREDUIWIN_AUTHPACKAGE_ONLY

Solo i provider di credenziali che supportano il pacchetto di autenticazione di input devono enumerare.

CREDUIWIN_IN_CRED_ONLY

È necessario enumerare solo le credenziali in ingresso per il pacchetto di autenticazione specifico.

CREDUIWIN_ENUMERATE_ADMINS

I provider di credenziali devono enumerare gli amministratori.

CREDUIWIN_ENUMERATE_CURRENT_USER

Solo le credenziali in ingresso

CREDUIWIN_PACK_32_WOW

[in] rgclsidProviders

Tipo: GUID*

Puntatore a una matrice di CLSID del provider di credenziali.

[in, out] rgbAllow

Tipo: BOOL*

Nella voce, un puntatore a una matrice di valori BOOL , uno per ogni membro corrispondente della matrice rgclsidProviders , tutti inizializzati su TRUE.

In uscita, contiene TRUE se il provider di credenziali corrispondente in rgclsidProviders può fornire un riquadro delle credenziali; in caso contrario, FALSE.

[in] cProviders

Tipo: DWORD

Numero di membri in rgbAllow o rgclsidProviders (devono essere uguali).

Valore restituito

Tipo: HRESULT

Restituisce sempre S_OK.

Commenti

Nella voce questo metodo riceve due matrici parallele; rgclsidProviders, che contiene i CLSID del provider di credenziali e rgbAllow, che contiene valori BOOL per i CLSID corrispondenti. ICredentialProviderFilter::Filter esamina ogni provider di credenziali in rgclsidProviders e decide se il provider di credenziali deve essere autorizzato ad enumerare i riquadri delle credenziali per lo scenario specificato da dwFlags. Se è accettabile, la voce corrispondente in rgbAllow è impostata su TRUE. Se questo è inaccettabile, è impostato su FALSE.

Non filtrare mai un CLSID per un provider di credenziali che non si conosce.

Non filtrare se le cpu sono CPUS_CREDUI e viene passato un valore dwFlags di CREDUIWIN_GENERIC.

È legittimo restituire successo dal metodo e non modificare rgbAllow.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	credentialprovider.h

Condividi tramite