QDnsTlsAssociationRecord Class
QDnsTlsAssociationRecord 类用于存储有关 DNS TLSA 记录的信息。更多内容...
| 头文件： | #include <QDnsTlsAssociationRecord> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake： | QT += network |
| 自： | Qt 6.8 |
- 所有成员列表（包括继承的成员）
- QDnsTlsAssociationRecord 属于网络编程 API和隐式共享类。
公共类型
| enum class | CertificateUsage { CertificateAuthorityConstrait, ServiceCertificateConstraint, TrustAnchorAssertion, DomainIssuedCertificate, PrivateUse, …, PrivCert } |
| enum class | MatchingType { Exact, Sha256, Sha512, PrivateUse, PrivMatch } |
| enum class | Selector { FullCertificate, SubjectPublicKeyInfo, PrivateUse, Cert, SPKI, PrivSel } |
公共函数
| QDnsTlsAssociationRecord() | |
| QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other) | |
| QDnsTlsAssociationRecord(QDnsTlsAssociationRecord &&other) | |
| ~QDnsTlsAssociationRecord() | |
| QDnsTlsAssociationRecord::MatchingType | matchType() const |
| QString | name() const |
| QDnsTlsAssociationRecord::Selector | selector() const |
| quint32 | timeToLive() const |
| QDnsTlsAssociationRecord::CertificateUsage | usage() const |
| QByteArray | value() const |
| QDnsTlsAssociationRecord & | operator=(const QDnsTlsAssociationRecord &other) |
另请参阅 QDnsLookup 。
成员类型文档
enum class QDnsTlsAssociationRecord::CertificateUsage
此枚举包含 TLS 会话查询中“证书用途”字段的有效值。以下列表已更新至RFC 6698第 2.1.1 节和 RFC 7218 第 2.1 节的最新内容。有关如何解释此枚举的权威说明，请参阅上述文档。
| 常量 | 值 | 描述 |
|---|---|---|
QDnsTlsAssociationRecord::CertificateUsage::CertificateAuthorityConstrait | 0 | 表示该记录包含与特定证书颁发机构（CA）的关联，该证书颁发机构必须出现在 TLS 服务器的证书链中，并且必须通过 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::ServiceCertificateConstraint | 1 | 表示该记录包含与某证书的关联，该证书必须与 TLS 服务器提供的终端实体证书匹配，并且必须通过 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::TrustAnchorAssertion | 2 | 表示该记录包含与某证书的关联，该证书必须用作验证 TLS 服务器证书的最终信任锚点，并且必须通过 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::DomainIssuedCertificate | 3 | 表示该记录包含与某证书的关联，该证书必须与 TLS 服务器提供的终端实体证书相匹配。不测试 PKIX 验证。 |
QDnsTlsAssociationRecord::CertificateUsage::PrivateUse | 255 | 无标准含义。 |
QDnsTlsAssociationRecord::CertificateUsage::PKIX_TA | 0 | 别名；公钥基础设施信任锚点的助记符 |
QDnsTlsAssociationRecord::CertificateUsage::PKIX_EE | 1 | 别名；公钥基础设施终端实体的助记符 |
QDnsTlsAssociationRecord::CertificateUsage::DANE_TA | 2 | 别名；DNS 基于命名实体认证（DNS-based Authentication of Named Entities）信任锚点的助记词 |
QDnsTlsAssociationRecord::CertificateUsage::DANE_EE | 3 | 别名；基于 DNS 的命名实体认证（DNS-based Authentication of Named Entities）终端实体的助记符 |
QDnsTlsAssociationRecord::CertificateUsage::PrivCert | 255 | 别名 |
其他值目前已被保留，但未来标准可能会取消其保留状态。即使未提供枚举器，此枚举也可用于这些值。
另请参阅 usage()。
enum class QDnsTlsAssociationRecord::MatchingType
此枚举包含 TLS 会话查询中“匹配类型”字段的有效值。以下列表已更新至RFC 6698第 2.1.3 节和 RFC 7218 第 2.3 节的最新内容。有关如何解释此枚举的权威说明，请参阅上述文档。
| 常量 | 值 | 描述 |
|---|---|---|
QDnsTlsAssociationRecord::MatchingType::Exact | 0 | 表示该证书或 SPKI 数据以原样形式存储在此记录中。 |
QDnsTlsAssociationRecord::MatchingType::Sha256 | 1 | 表示这是该记录中证书或 SPKI 数据的 SHA-256 校验和。 |
QDnsTlsAssociationRecord::MatchingType::Sha512 | 2 | 表示此记录中包含的证书或 SPKI 数据的 SHA-512 校验和。 |
QDnsTlsAssociationRecord::MatchingType::PrivateUse | 255 | 无标准含义。 |
QDnsTlsAssociationRecord::MatchingType::PrivMatch | PrivateUse | 别名 |
其他值目前已被保留，但未来标准可能会解除其保留状态。即使未提供枚举器，此枚举也可用于这些值。
另请参阅 matchType()。
enum class QDnsTlsAssociationRecord::Selector
此枚举包含 TLS 关联查询中“selector”字段的有效值。以下列表已更新至符合RFC 6698第 2.1.2 节和 RFC 7218 第 2.2 节的规定。有关如何解释此枚举的权威说明，请参阅上述文档。
| 常量 | 值 | 描述 |
|---|---|---|
QDnsTlsAssociationRecord::Selector::FullCertificate | 0 | 表示该记录指代以二进制结构形式存储的完整证书。 |
QDnsTlsAssociationRecord::Selector::SubjectPublicKeyInfo | 1 | 表示该记录指代证书的主题和公钥信息，采用 DER 编码的二进制结构形式。 |
QDnsTlsAssociationRecord::Selector::PrivateUse | 255 | 无标准含义。 |
QDnsTlsAssociationRecord::Selector::Cert | FullCertificate | 别名 |
QDnsTlsAssociationRecord::Selector::SPKI | SubjectPublicKeyInfo | 别名 |
QDnsTlsAssociationRecord::Selector::PrivSel | PrivateUse | 别名 |
其他值目前被保留，但未来标准可能会取消其保留状态。即使未提供枚举器，该枚举也可用于这些值。
另请参阅 selector()。
成员函数文档
QDnsTlsAssociationRecord::QDnsTlsAssociationRecord()
构建一个空的 TLS 关联记录。
QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(const QDnsTlsAssociationRecord &other)
创建other 的副本。
[constexpr noexcept default] QDnsTlsAssociationRecord::QDnsTlsAssociationRecord(QDnsTlsAssociationRecord &&other)
通过Move构造一个QDnsTlsAssociationRecord 的实例。
[noexcept] QDnsTlsAssociationRecord::~QDnsTlsAssociationRecord()
销毁此 TLS 关联记录对象。
QDnsTlsAssociationRecord::MatchingType QDnsTlsAssociationRecord::matchType() const
返回该记录的匹配类型字段。
QString QDnsTlsAssociationRecord::name() const
返回该记录的名称。
QDnsTlsAssociationRecord::Selector QDnsTlsAssociationRecord::selector() const
返回该记录的选择器字段。
quint32 QDnsTlsAssociationRecord::timeToLive() const
返回该记录的有效时长（以秒为单位）。
QDnsTlsAssociationRecord::CertificateUsage QDnsTlsAssociationRecord::usage() const
返回此记录的证书使用情况字段。
QByteArray QDnsTlsAssociationRecord::value() const
返回该记录的二进制数据字段。该二进制数据的解释取决于由 certificateUsage()、selector() 和matchType() 提供的三个数值字段。
请注意，这是一个二进制字段，即使是校验和也是如此，这与QCyrptographicHash::result()返回的结果类似。
QDnsTlsAssociationRecord &QDnsTlsAssociationRecord::operator=(const QDnsTlsAssociationRecord &other)
将other 中的内容移动到此对象中。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
