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.

Valor	Significado
CPFG_LOGON_USERNAME da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b	Nombre de usuario escrito en un cuadro de texto.
CPFG_LOGON_PASSWORD 60624cfa-a477-47b1-8a8e-3a4a19981827	Contraseña escrita en un cuadro de texto.
CPFG_SMARTCARD_USERNAME 3e1ecf69-568c-4d96-9d59-46444174e2d6	Nombre de usuario obtenido de una tarjeta inteligente insertada.
CPFG_SMARTCARD_PIN 4fe5263b-9181-46c1-b0a4-9dedd4db7dea	El PIN obtenido de una tarjeta inteligente insertada.
CPFG_CREDENTIAL_PROVIDER_LOGO 2d837775-f6cd-464e-a745-482fd0b47493	Introducida en Windows 8: la imagen usada para representar un proveedor de credenciales en la página de inicio de sesión.
CPFG_CREDENTIAL_PROVIDER_LABEL 286BBFF3-BAD4-438F-B007-79B7267C3D48	Introducido en Windows 8: etiqueta asociada a un proveedor de credenciales en la página de inicio de sesión.

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

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