DebugDirectoryEntryType 枚举

定义

public enum class DebugDirectoryEntryType
public enum DebugDirectoryEntryType
type DebugDirectoryEntryType = 
Public Enum DebugDirectoryEntryType
继承
DebugDirectoryEntryType

字段

CodeView 2

关联的 PDB 文件说明。Associated PDB file description.

Coff 1

COFF 调试信息(行号、符号表和字符串表)。The COFF debug information (line numbers, symbol table, and string table). 此类调试信息也由文件标头中的字段指向。This type of debug information is also pointed to by fields in the file headers.

EmbeddedPortablePdb 17

该项指向包含嵌入式可移植 PDB 的 blob。The entry points to a blob containing Embedded Portable PDB. 嵌入式可移植 PDB blob 具有以下格式:The Embedded Portable PDB blob has the following format:

- blob ::= uncompressed-size data- blob ::= uncompressed-size data

- 数据跨越 blob 的其余部分并包含 Deflate 压缩的可移植 PDB。- Data spans the remainder of the blob and contains a Deflate-compressed Portable PDB.

PdbChecksum 19

该项存储生成 PE/COFF 文件所使用的符号文件的内容的加密哈希。The entry stores a crypto hash of the content of the symbol file the PE/COFF file was built with. 哈希可用于验证给定的 PDB 文件是否是使用 PE/COFF 文件生成的,且不能以任何方式更改。The hash can be used to validate that a given PDB file was built with the PE/COFF file and not altered in any way. 如果在生成 PE/COFF 文件的过程中生成了多个 PDB,则可能会出现多项(例如,专用和公共符号)。More than one entry can be present if multiple PDBs were produced during the build of the PE/COFF file (e.g. private and public symbols).

Reproducible 16

如果出现此项,则表示存在确定的 PE/COFF 文件。The presence of this entry indicates a deterministic PE/COFF file. 有关详细信息,请参阅备注部分。See the Remarks section for more information.

Unknown 0

未知值,所有工具都应忽略。An unknown value that should be ignored by all tools.

注解

有关与各个枚举成员相关的规范,请参阅以下内容:See the following for the specifications related to individual enumeration members:

成员Member 规范Specification
CodeView CodeView 调试目录项(类型2)CodeView Debug Directory Entry (type 2)
EmbeddedPortablePdb Embedded Portale PDB 调试目录条目(类型为17)Embedded Portale PDB Debu Directory Entry (type 17)
PdbChecksum PDB 校验和调试目录条目(类型19)PDB Checksum Debug Directory Entry (type 19)
Reproducible 请参阅确定性调试目录条目(类型为16)See Deterministic Debug Directory Entry (type 16)

DebugDirectoryEntryTypeDebugDirectoryEntryType.Reproducible

生成确定性 PE/COFF 文件的工具可保证该文件的整个内容仅基于提供给该工具的记录输入(如源文件、资源文件、编译器选项等),而不是环境环境变量(例如,当前时间、操作系统、运行该工具的进程的位数等。The tool that produced the deterministic PE/COFF file guarantees that the entire content of the file is based solely on documented inputs given to the tool (such as source files, resource files, compiler options, etc.) rather than ambient environment variables (such as the current time, the operating system, the bitness of the process running the tool, etc.).

具有确定性的 PE/COFF 文件的 COFF 文件头中的 TimeDateStamp 字段的值并不表示该文件的生成日期和时间,不应以这种方式进行解释。The value of the TimeDateStamp field in the COFF File Header of a deterministic PE/COFF file does not indicate the date and time when the file was produced and should not be interpreted that way. 相反,字段的值派生自文件内容的哈希。Instead, the value of the field is derived from a hash of the file content. 用于计算此值的算法是生成文件的工具的实现细节。The algorithm to calculate this value is an implementation detail of the tool that produced the file.

类型 Reproducible 的调试目录条目必须包含除 @no__t 零以外的所有字段。The debug directory entry of type Reproducible must have all fields except for DebugDirectoryEntry.Type zeroed.

适用于