estructura de CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR (credentialprovider.h)

Describe un único campo de una credencial. Por ejemplo, una cadena o una imagen de usuario.

Sintaxis

typedef struct _CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR {
  DWORD                          dwFieldID;
  CREDENTIAL_PROVIDER_FIELD_TYPE cpft;
  LPWSTR                         pszLabel;
  GUID                           guidFieldType;
} CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR;

Miembros

dwFieldID

Tipo: DWORD

Identificador único del campo. Los campos deben tener un identificador único en comparación con todos los demás campos de un proveedor de credenciales determinado. Esto es true independientemente de si los campos se muestran u ocultan.

cpft

Tipo: CREDENTIAL_PROVIDER_FIELD_TYPE

Tipo de campo.

pszLabel

Tipo: LPWSTR

Puntero a un búfer que contiene el nombre descriptivo del campo como una cadena Unicode terminada en null. Esto se usa con fines de accesibilidad y cola. Por ejemplo, algunos campos estándar tendrían nombres de confianza de "Nombre de usuario", "Contraseña" e "Iniciar sesión en".

guidFieldType

Tipo: GUID

GUID que identifica de forma única un tipo de campo. Este miembro le permite ajustar la funcionalidad proporcionada por los proveedores de credenciales existentes en sus propios proveedores. No se recomienda ajustar los proveedores de credenciales, ya que puede provocar un comportamiento inesperado que deshabilita los proveedores de credenciales en el cuadro.

En la tabla siguiente se enumeran los valores guidFieldType admitidos por Windows. Se definen en Shlguid.h.

Comentarios

Cada elemento de interfaz de usuario presentado al usuario en un icono se define mediante el proveedor de credenciales como un campo. El CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR es cómo identifica el proveedor de credenciales los campos. Una vez definido un campo para un escenario de uso determinado, no se puede agregar ni restar de . Los proveedores de credenciales deben definir completamente todos sus campos antes de enumerar iconos. Si los campos van a aparecer o desaparecer como parte del proceso de adquisición de credenciales, esos campos aún no se definirán con antelación. Use CREDENTIAL_PROVIDER_FIELD_STATE para ocultar o mostrar los campos según sea necesario.

Requisitos