Estructura CREDENTIALA (wincred.h)
La estructura CREDENTIAL
Sintaxis
typedef struct _CREDENTIALA {
DWORD Flags;
DWORD Type;
LPSTR TargetName;
LPSTR Comment;
FILETIME LastWritten;
DWORD CredentialBlobSize;
LPBYTE CredentialBlob;
DWORD Persist;
DWORD AttributeCount;
PCREDENTIAL_ATTRIBUTEA Attributes;
LPSTR TargetAlias;
LPSTR UserName;
} CREDENTIALA, *PCREDENTIALA;
Miembros
Flags
Miembro de bits que identifica las características de la credencial. Los bits no definidos deben inicializarse como cero y no modificarse para permitir futuras mejoras.
Type
Tipo de la credencial. Este miembro no se puede cambiar después de crear la credencial. Los siguientes valores son válidos.
TargetName
Nombre de la credencial. Los miembros de TargetName y Type identifican de forma única la credencial. Este miembro no se puede cambiar después de crear la credencial. En su lugar, se debe eliminar la credencial con el nombre anterior y la credencial con el nuevo nombre creado.
Si type es CRED_TYPE_DOMAIN_PASSWORD o CRED_TYPE_DOMAIN_CERTIFICATE, este miembro identifica el servidor o los servidores para los que se va a usar la credencial. El miembro es un nombre de servidor NetBIOS o DNS, un sufijo de nombre de host DNS que contiene un carácter comodín, un nombre de dominio NetBIOS o DNS que contiene una secuencia de caracteres comodín o un asterisco.
Si targetName es un nombre de host DNS, el miembro TargetAlias puede ser el nombre NetBIOS del host.
Si el TargetName es un sufijo de nombre de host DNS que contiene un carácter comodín, la etiqueta situada más a la izquierda del nombre de host DNS es un asterisco (*), que indica que el nombre de destino es cualquier servidor cuyo nombre termine en el nombre especificado, por ejemplo, *.microsoft.com.
Si el TargetName es un nombre de dominio que contiene una secuencia de caracteres comodín, la sintaxis es el nombre de dominio seguido de una barra diagonal inversa y asterisco (*), lo que indica que el nombre de destino es cualquier servidor que sea miembro del dominio con nombre (o dominio).
Si targetName es un nombre de dominio DNS que contiene una secuencia de caracteres comodín, el miembro TargetAlias puede ser un nombre de dominio NetBIOS que use una secuencia de caracteres comodín para el mismo dominio.
Si TargetName especifica un recurso compartido DFS, por ejemplo, DfsRoot\DfsShare, esta credencial coincide con el recurso compartido DFS específico y los servidores alcanzados a través de ese recurso compartido DFS.
Si targetName es un único asterisco (*), esta credencial coincide con cualquier nombre de servidor.
Si TargetName es CRED_SESSION_WILDCARD_NAME, esta credencial coincide con cualquier nombre de servidor. Esta credencial coincide con antes de un único asterisco y solo es válida si persistente es CRED_PERSIST_SESSION. Las aplicaciones que quieran invalidar temporalmente la credencial predeterminada pueden establecer la credencial.
Este miembro no puede tener más de CRED_MAX_DOMAIN_TARGET_NAME_LENGTH (337) caracteres.
Si el tipo de
Este miembro no distingue mayúsculas de minúsculas.
Comment
Comentario de cadena del usuario que describe esta credencial. Este miembro no puede tener más de CRED_MAX_STRING_LENGTH (256) caracteres.
LastWritten
La hora, en hora universal coordinada (hora media de Greenwich), de la última modificación de la credencial. En el caso de las operaciones de escritura, se omite el valor de este miembro.
CredentialBlobSize
Tamaño, en bytes, del miembro CredentialBlob. Este miembro no puede ser mayor que CRED_MAX_CREDENTIAL_BLOB_SIZE (5*512) bytes.
CredentialBlob
Datos secretos de la credencial. El miembro CredentialBlob puede leerse y escribirse.
Si el miembro Type es CRED_TYPE_DOMAIN_PASSWORD, este miembro contiene la contraseña Unicode de texto no cifrado para UserName. El
Si el miembro type de
Si el miembro
Se espera que las credenciales sean portátiles. Las aplicaciones deben asegurarse de que los datos de CredentialBlob sean portátiles. La aplicación define el byte-endian y la alineación de los datos en CredentialBlob.
Persist
Define la persistencia de esta credencial. Este miembro se puede leer y escribir.
AttributeCount
Número de atributos definidos por la aplicación que se van a asociar a la credencial. Este miembro se puede leer y escribir. Su valor no puede ser mayor que CRED_MAX_ATTRIBUTES (64).
Attributes
Atributos definidos por la aplicación asociados a la credencial. Este miembro se puede leer y escribir.
TargetAlias
Alias del miembro targetName de
Si la credencial type es CRED_TYPE_GENERIC, este miembro puede ser distinto deNULL, pero el administrador de credenciales omite el miembro.
UserName
Nombre de usuario de la cuenta usada para conectarse a TargetName.
Si la credencial Type es CRED_TYPE_DOMAIN_PASSWORD, este miembro puede ser un DomainNameUserName o un UPN.
Si la credencial Type es CRED_TYPE_DOMAIN_CERTIFICATE, este miembro debe ser una referencia de certificado serializado creada llamando a CredMarshalCredential con certCredential.
Si la credencial type es CRED_TYPE_GENERIC, este miembro puede ser distinto deNULL, pero el administrador de credenciales omite el miembro.
Este miembro no puede tener más de CRED_MAX_USERNAME_LENGTH (513) caracteres.
Observaciones
Nota
El encabezado wincred.h define CREDENTIAL como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| encabezado de |
wincred.h |