Compartir a través de

Método ICredentialProviderFilter::Filter (credentialprovider.h)

  • Artículo

Evalúa si se debe permitir una lista de proveedores de credenciales para proporcionar iconos de credenciales.

Sintaxis

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

Parámetros

[in] cpus

Tipo: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Puntero a un valor de CREDENTIAL_PROVIDER_USAGE_SCENARIO que declara los escenarios en los que se admite un proveedor de credenciales.

[in] dwFlags

Tipo: DWORD

Marcas de escenario de uso. Este parámetro solo es válido si se CPUS_CREDUI cpus . Se definen en Wincred.h.

CREDUIWIN_GENERIC

Se solicita el nombre de usuario o la contraseña de texto sin formato.

CREDUIWIN_CHECKBOX

Muestra la casilla Guardar credencial .

CREDUIWIN_AUTHPACKAGE_ONLY

Solo los proveedores de credenciales que admiten el paquete de autenticación de entrada deben enumerarse.

CREDUIWIN_IN_CRED_ONLY

Solo se debe enumerar la credencial entrante para el paquete de autenticación específico.

CREDUIWIN_ENUMERATE_ADMINS

Los proveedores de credenciales deben enumerar los administradores.

CREDUIWIN_ENUMERATE_CURRENT_USER

Solo la credencial entrante

CREDUIWIN_PACK_32_WOW

[in] rgclsidProviders

Tipo: GUID*

Puntero a una matriz de CLSID del proveedor de credenciales.

[in, out] rgbAllow

Tipo: BOOL*

En la entrada, un puntero a una matriz de valores BOOL , uno para cada miembro correspondiente de la matriz rgclsidProviders , todos inicializados en TRUE.

Al salir, contiene TRUE si el proveedor de credenciales correspondiente en rgclsidProviders puede proporcionar un icono de credenciales; de lo contrario, FALSE.

[in] cProviders

Tipo: DWORD

Número de miembros en rgbAllow o rgclsidProviders (deben ser iguales).

Valor devuelto

Tipo: HRESULT

Siempre devuelve S_OK.

Comentarios

En la entrada, este método recibe dos matrices paralelas; rgclsidProviders, que contiene los CLSID del proveedor de credenciales y rgbAllow, que contiene valores BOOL para los CLSID correspondientes. ICredentialProviderFilter::Filter examina cada proveedor de credenciales en rgclsidProviders y decide si se debe permitir que el proveedor de credenciales enumere los iconos de credenciales para el escenario especificado por dwFlags. Si esto es aceptable, la entrada correspondiente en rgbAllow se establece en TRUE. Si esto es inaceptable, se establece en FALSE.

No filtre nunca un CLSID para un proveedor de credenciales que no sepa.

No filtre si las cpus se CPUS_CREDUI y se pasa un valor dwFlags de CREDUIWIN_GENERIC.

Es legítimo devolver el éxito del método y no modificar rgbAllow.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h