wincred.h) (CREDENTIALA 结构
CREDENTIAL 结构包含单个凭据。
语法
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;
成员
Flags
标识凭据特征的位成员。 未定义的位应初始化为零，否则不应更改以允许将来的增强。
| 值 | 含义 |
|---|---|
|
如果凭据未保留 CredentialBlob ，并且此登录会话期间尚未写入凭据，则设置位。 此位在输入时将被忽略，并在查询时自动设置。
如果 Type为CRED_TYPE_DOMAIN_CERTIFICATE，则不会跨登录会话保留 CredentialBlob ，因为证书的 PIN 是非常敏感的信息。 事实上，将凭据写入凭据管理器时，PIN 会传递给与证书关联的 CSP。 CSP 将强制实施适用于证书的 PIN 保留策略。 如果 Type为CRED_TYPE_DOMAIN_PASSWORD 或 CRED_TYPE_DOMAIN_CERTIFICATE，则身份验证包在使用标记为 CRED_FLAGS_PROMPT_NOW的凭据时，身份验证尝试始终失败。 应用程序通常通过密钥环 UI (，) 提示用户输入密码。 应用程序保存凭据并重试身份验证。 由于凭据最近已写入，因此身份验证包现在获取的凭据未标记为CRED_FLAGS_PROMPT_NOW。 |
|
如果此凭据的 TargetName 成员设置为与 UserName 成员相同的值，则设置位。 此类凭据旨在存储特定用户的 CredentialBlob 。 有关详细信息，请参阅 CredMarshalCredential 函数。
仅当 Type为CRED_TYPE_DOMAIN_PASSWORD 或 CRED_TYPE_DOMAIN_CERTIFICATE时，才能指定此位。 |
Type
凭据的类型。 创建凭据后，无法更改此成员。 以下值有效。
TargetName
该凭据的名称。 TargetName 和 Type 成员唯一标识凭据。 创建凭据后，无法更改此成员。 相反，应删除具有旧名称的凭据，并创建具有新名称的凭据。
如果 Type为CRED_TYPE_DOMAIN_PASSWORD 或 CRED_TYPE_DOMAIN_CERTIFICATE，则此成员标识凭据要用于的服务器。 成员是 NetBIOS 或 DNS 服务器名称、包含通配符的 DNS 主机名后缀、包含通配符序列的 NetBIOS 或 DNS 域名或星号。
如果 TargetName 是 DNS 主机名， 则 TargetAlias 成员可以是主机的 NetBIOS 名称。
如果 TargetName 是包含通配符的 DNS 主机名后缀，则 DNS 主机名最左侧的标签是星号 (*) ，表示目标名称是名称以指定名称结尾的任何服务器，例如 *.microsoft.com。
如果 TargetName 是包含通配符序列的域名，则语法是域名后跟反斜杠和星号 (*) ，表示目标名称是属于命名域 (或领域) 的任何服务器。
如果 TargetName 是包含通配符序列的 DNS 域名， 则 TargetAlias 成员可以是对同一域使用通配符序列的 NetBIOS 域名。
如果 TargetName 指定 DFS 共享（例如 DfsRoot\DfsShare），则此凭据将匹配特定的 DFS 共享以及通过该 DFS 共享访问的任何服务器。
如果 TargetName 是单个星号 (*) ，则此凭据与任何服务器名称匹配。
如果 TargetName 是CRED_SESSION_WILDCARD_NAME，则此凭据与任何服务器名称匹配。 此凭据在单个星号之前匹配，并且仅在“持久化”为CRED_PERSIST_SESSION时才有效。 凭据可由希望临时替代默认凭据的应用程序设置。
此成员长度不能超过 CRED_MAX_DOMAIN_TARGET_NAME_LENGTH (337) 个字符。
如果 Type 为CRED_TYPE_GENERIC，则此成员应标识除实际目标外使用凭据的服务。 Microsoft 建议名称以实施服务的公司名称为前缀。 Microsoft 将使用前缀“Microsoft”。 Microsoft 编写的服务应追加其服务名称，例如 Microsoft_RAS_TargetName。 此成员长度不能超过 CRED_MAX_GENERIC_TARGET_NAME_LENGTH ( 32767) 个字符。
此成员不区分大小写。
Comment
描述此凭据的用户的字符串注释。 此成员长度不能超过 CRED_MAX_STRING_LENGTH (256) 个字符。
LastWritten
协调世界时 (格林威治平均时间) ，上次修改凭据的时间。 对于写入操作，忽略此成员的值。
CredentialBlobSize
CredentialBlob 成员的大小（以字节为单位）。 此成员不能大于 CRED_MAX_CREDENTIAL_BLOB_SIZE ( 5*512) 字节。
CredentialBlob
凭据的机密数据。 CredentialBlob 成员可以读取和写入。
如果 Type 成员 CRED_TYPE_DOMAIN_PASSWORD，则此成员包含 UserName 的纯文本 Unicode 密码。 CredentialBlob 和 CredentialBlobSize 成员不包含尾随零字符。 此外，对于 CRED_TYPE_DOMAIN_PASSWORD，此成员只能由身份验证包读取。
如果 Type 成员 CRED_TYPE_DOMAIN_CERTIFICATE，则此成员包含 UserName 的清除测试 Unicode PIN。 CredentialBlob 和 CredentialBlobSize 成员不包含尾随零字符。 此外，此成员只能由身份验证包读取。
如果 Type 成员 CRED_TYPE_GENERIC，则此成员由应用程序定义。
凭据应是可移植的。 应用程序应确保 CredentialBlob 中的数据可移植。 应用程序定义 CredentialBlob 中数据的字节尾号和对齐方式。
Persist
定义此凭据的持久性。 此成员可以读取和写入。
AttributeCount
要与凭据关联的应用程序定义属性的数目。 此成员可以读取和写入。 其值不能大于 CRED_MAX_ATTRIBUTES (64) 。
Attributes
与凭据关联的应用程序定义属性。 此成员可以读取和写入。
TargetAlias
TargetName 成员的别名。 此成员可以读取和写入。 长度不能超过 CRED_MAX_STRING_LENGTH (256) 个字符。
如果凭据类型CRED_TYPE_GENERIC，则此成员可以是非 NULL，但凭据管理器会忽略该成员。
UserName
用于连接到 TargetName 的帐户的用户名。
如果凭据类型CRED_TYPE_DOMAIN_PASSWORD，则此成员可以是 DomainNameUserName 或 UPN。
如果凭据类型为CRED_TYPE_DOMAIN_CERTIFICATE，则此成员必须是通过使用 CertCredential 调用 CredMarshalCredential 创建的封送证书引用。
如果凭据类型CRED_TYPE_GENERIC，则此成员可以是非 NULL，但凭据管理器会忽略该成员。
此成员长度不能超过 CRED_MAX_USERNAME_LENGTH (513) 个字符。
注解
注意
wincred.h 标头将 CREDENTIAL 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 标头 | wincred.h |