Share via

estructura de CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR (credentialprovider.h)

  • Artículo

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