Share via


Microsoft.VisualStudio.Debugger.Symbols Namespace

Klassen

DkmBasicInstructionSymbolInfo

Enthält grundlegende Symbolinformationen zu einer Anweisung. Dies wird in erster Linie verwendet, um Symbolinformationen für native Stapelrahmen für jeden Framefilter bereitzustellen. Dies wird als Netzwerk-/IPC-Optimierung verwendet, wenn Symbole in einem separaten Prozess geladen werden, indem die grundlegenden Informationen in einer einzelnen Rundreise gesammelt werden.

Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.

DkmCustomSymbolFileId

Die benutzerdefinierten Debuginformationen werden aufgefüllt, wenn ein Modul geladen wird und der Debugmonitor den Inhalt des Debugverzeichnisses nicht versteht.

DkmDynamicSymbolFileId

Dies wird für dynamische In-Memory-Module beim verwalteten Debuggen verwendet.

DkmEmbeddedDocument

DkmEmbeddedDocument stellt eine in eine Symboldatei eingebettete Quelldatei dar.

Diese API wurde in Visual Studio 15 Update 5 (DkmApiVersion.VS15Update5) eingeführt.

DkmEmbeddedDwarfSymbolFileId

Marker, dass das zugeordnete Modul instance eingebettete DWARF-Daten enthält.

Diese API wurde in Visual Studio 16 Update 5 (DkmApiVersion.VS16Update5) eingeführt.

DkmEmbeddedPdbFileId

Enthält Informationen aus dem Abschnitt "MPDB" des Debugverzeichnisses des Moduls.

Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.

DkmEngineSymbolSettings

Enthält die Symbolpfadsammlung und den Cachepfad.

DkmExpensiveHashAlgorithmKind

GUID-Bezeichner für "teure" Hashes. Ein teurer Hash ist ein Hash, der möglicherweise Rechenarbeit erfordert, z. B. das Herunterladen oder Dekompilieren eines Dokuments.

DkmHashValue

Wert eines berechneten kryptografischen Hashs, der möglicherweise eine Prüfsumme darstellt.

Diese API wurde in Visual Studio 15 Update 9 (DkmApiVersion.VS15Update9) eingeführt.

DkmInstructionSymbol

DkmInstructionSymbol stellt eine Methode im Zielprozess dar.

Abgeleitete Klassen: DkmClrInstructionSymbol, DkmClrNcInstructionSymbol, DkmCustomInstructionSymbol, DkmNativeInstructionSymbol, DkmScriptInstructionSymbol

DkmModule

Die DkmModule-Klasse stellt ein Codebündel (z. B. dll oder exe) dar, das oder einmal in einen oder mehrere Prozesse geladen wurde. Die DkmModule-Klasse ist das zentrale Objekt der Symbol-APIs und ist 1:1 mit der Notation des Geladenen durch den Symbolhandler. Wenn ein Codebündel in drei verschiedene Prozesse (oder denselben Prozess, aber mit drei verschiedenen Basisadressen oder drei verschiedenen App-Domänen) geladen wird, der Symbolhandler jedoch alle als identisch angibt, gibt es nur ein Modulobjekt.

DkmPdbFileId

Enthält die Informationen, die sich im Abschnitt "RSDS" des Debugverzeichnisses des Moduls befinden. Der Mvid-Teil dieser Informationen ist in der Mvid unveränderlich.

DkmResolvedDocument

Objekt, das das Ergebnis einer Quelldateiabfrage für eine Symboldatei (PDB) darstellt. Das aufgelöste Dokumentobjekt kann mehrere Dokumentdatensätze mit der Symboldatei kapseln. Beispielsweise gibt es bei der C++-Kompilierung jedes Mal, wenn eine Headerdatei enthalten ist, ein weiterer Verweis in der PDB-Datei. Es gibt jedoch nur ein DkmResolvedDocument-Objekt für die Headerdatei.

Abgeleitete Klassen: DkmResolvedMappedDocument

DkmResolvedMappedDocument

Aufgelöstes Dokumentobjekt, das aus einem erfolgreichen Aufruf von DkmModule.FindMappedDocuments oder DkmScriptDocument.TryMappedResolve erstellt wird. Dies enthält die Informationen zum Zuordnen von Anforderungen in serverseitigen Dokumenten zu Anforderungen im clientseitigen Dokument.

DkmSourceFileHash

Wert eines berechneten Hashs. Hashes werden für die Dokumentprüfsummenfunktion verwendet, die einen nicht sicherheitsrelevanten Zweck hat.

Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.

DkmSourceFileId

Identifiziert eine Quelldatei und stellt die Informationen bereit, die ein Symbolhandler verwenden könnte, um eine Symboldatei (PDB) nach Informationen zu dieser Quelldatei zu durchsuchen.

DkmSourceFileId.MD5Hash

MD5-Hashwert für dieses Dokument.

DkmSourceFileId.SHA1Hash

SHA-1-Hashwert für dieses Dokument.

DkmSourceLinkInfo

DkmSourceLinkInfo stellt Source Link Informationen dar, die aus einer Symboldatei abgerufen wurden.

Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.

DkmSourcePosition

Quellcodeposition, die einem Codeelement entspricht. Die kann einen Speicherort darstellen, der aus einer Symboldatei (PDB) extrahiert wurde, oder der Speicherort eines Haltepunkts in der IDE sein.

DkmSymbolFileId

Enthält Informationen, die zum Suchen nach Symbolen für dieses Modul erforderlich sind. Unter Win32 sind diese Informationen im IMAGE_DEBUG_DIRECTORY enthalten.

Abgeleitete Klassen: DkmCustomSymbolFileId, DkmDynamicSymbolFileId, DkmPdbFileId, DkmEmbeddedPdbFileId, DkmEmbeddedDwarfSymbolFileId

DkmSymbolProviderId

Eindeutiger Bezeichner für Symboldateien/Symbolanbieter.

DkmSymbolsDocument

DkmSymbolsDocument stellt ein Dokument in einer Symboldatei dar.

Diese API wurde in Visual Studio 16 Update 5 (DkmApiVersion.VS16Update5) eingeführt.

DkmSymbolsDocumentType

Guid-Wert, der den Typ eines Symboldokuments beschreibt.

Strukturen

DkmCodeViewCompilerId

DkmCodeViewCompilerId wird verwendet, um Informationen innerhalb der S_COMPILE*-Codesichtdatensätze in eine DkmCompilerId zu übersetzen. Dadurch kann der Debugger einen geeigneten Ausdrucksauswerter für einen Stapelrahmen laden. Symbolanbieter können diese Sammlung über DkmEngineSettings abrufen. Ausdrucksauswerter können dieser Sammlung zusätzliche Einträge hinzufügen, indem ihr Setup dem Registrierungsschlüssel "%VSRegistryRoot%\Debugger\CodeView Compilers" Unterschlüssel hinzufügen.

DkmEnumSymbolsDocumentsAsyncResult

Ergebnis eines asynchronen DkmModule.EnumSymbolsDocuments-Aufrufs.

DkmFindDocumentsAsyncResult

Ergebnis eines asynchronen DkmModule.FindDocuments-Aufrufs.

DkmFindSymbolsAsyncResult

Ergebnis eines asynchronen DkmResolvedDocument.FindSymbols-Aufrufs.

DkmGetBasicSymbolInfoAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetBasicInfo-Aufrufs.

DkmGetCompilerIdAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetCompilerId-Aufrufs.

DkmGetFunctionInfoAsyncResult

Ergebnis eines asynchronen DkmModule.GetFunctionInfo-Aufrufs.

DkmGetInlineFramesCountAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetInlineFramesCount-Aufrufs.

DkmGetInlineSourcePositionAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetInlineSourcePosition-Aufrufs.

DkmGetMethodSymbolStoreDataAsyncResult

Ergebnis eines asynchronen DkmModule.GetMethodSymbolStoreData-Aufrufs.

DkmGetMethodSymbolStoreDataPreRemapAsyncResult

Ergebnis eines asynchronen DkmModule.GetMethodSymbolStoreDataPreRemap-Aufrufs.

DkmGetPublicSymbolByNameCallbackAsyncResult

Ergebnis eines asynchronen DkmModule.GetPublicSymbolByNameCallback-Aufrufs.

DkmGetRegisterRelativeSymbolNameAsyncResult

Ergebnis eines asynchronen DkmModule.GetRegisterRelativeSymbolName-Aufrufs.

DkmGetSourceLinkDataAsyncResult

Ergebnis eines asynchronen DkmModule.GetSourceLinkData-Aufrufs.

DkmGetSourcePositionAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetSourcePosition-Aufrufs.

DkmGetSourcePositionCallbackAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetSourcePositionCallback-Aufrufs.

DkmGetSourceServerDataAsyncResult

Ergebnis eines asynchronen DkmModule.GetSourceServerData-Aufrufs.

DkmGetSteppingRangesAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetSteppingRanges-Aufrufs.

DkmGetSymbolFilePathAsyncResult

Ergebnis eines asynchronen DkmModule.GetSymbolFilePath-Aufrufs.

DkmGetSymbolNameForRVAAsyncResult

Ergebnis eines asynchronen DkmModule.GetSymbolNameForRVA-Aufrufs.

DkmGetSymbolStatusMessageAsyncResult

Ergebnis eines asynchronen DkmModuleInstance.GetSymbolStatusMessage-Aufrufs.

DkmGetTokenSymbolStoreAttributeAsyncResult

Ergebnis eines asynchronen DkmModule.GetTokenSymbolStoreAttribute-Aufrufs.

DkmGetUserCodeSourcePositionCallbackAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.GetUserCodeSourcePositionCallback-Aufrufs.

DkmHasLineInfoAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.HasLineInfo-Aufrufs.

DkmImageDebugDirectoryFormat

Windows-DLLs/exes enthalten einen Abschnitt mit Debuginformationen. In diesem Abschnitt gibt es null oder mehr IMAGE_DEBUG_DIRECTORY-Strukturen, und in jeder dieser Strukturen befindet sich ein 32-Bit-Feld "Type", das das Format der Informationen im Debugverzeichnis angibt. DkmImageDebugDirectoryFormat wird verwendet, um diesen Typwert dem Symbolanbieter zuzuordnen, der zum Verarbeiten dieser Art von Debuginformationen verwendet wird. Der Debugger initialisiert eine Auflistung von DkmImageDebugDirectoryFormat-Strukturen beim Start, indem er die Registrierungsschlüssel "%VSRegistryRoot%\Debugger\Image Debug Directory Formats" liest.

DkmIsHiddenCodeAsyncResult

Ergebnis eines asynchronen DkmInstructionSymbol.IsHiddenCode-Aufrufs.

DkmIsUserCodeAsyncResult

Ergebnis eines asynchronen DkmInstructionAddress.IsUserCode-Aufrufs.

DkmMD5HashValue

Wert eines berechneten MD5-Hashs. MD5-Hashes werden für die Dokumentprüfsummenfunktion verwendet, die ein nicht sicherheitsrelevanter Zweck ist. MD5 sollte nicht mehr für sicherheitsrelevante Zwecke verwendet werden.

DkmModuleId

Guid-Paar, das verwendet wird, um eine bestimmte DkmModule-instance eindeutig zu identifizieren.

DkmRVASizePair

Ein RVA- und Größenpaar, das ein von DkmModule GetFunctionInfo zurückgegebenes Symbol darstellt.

DkmSHA1HashValue

Wert eines berechneten SHA-1-Hashs. SHA-1-Hashes werden für die Dokumentprüfsummenfunktion verwendet, die ein nicht sicherheitsrelevanter Zweck ist. SHA-1 sollte nicht mehr für sicherheitsrelevante Zwecke verwendet werden.

DkmSteppingRange

Ein Offset-Größenpaar, das vom Symbolanbieter an einen Debugmonitor zurückgegeben wird, um einen Bereich von Anweisungen anzugeben, bei denen der Debugger nicht anhalten sollte.

DkmTextSpan

Der Anfangs-, Endzeilen-/Spaltenbereich für eine zusammenhängende Textspanne.

DkmTryLoadSymbolsAsyncResult

Ergebnis eines asynchronen DkmModuleInstance.TryLoadSymbols-Aufrufs.

DkmTryLoadSymbolsCallback177AsyncResult

Ergebnis eines asynchronen DkmModuleInstance.TryLoadSymbolsCallback177-Aufrufs.

DkmTryLoadSymbolsCallbackAsyncResult

Ergebnis eines asynchronen DkmModuleInstance.TryLoadSymbolsCallback-Aufrufs.

Enumerationen

DkmBasicSymbolInfoRequestFlags

An DkmInstructionSymbol.GetBasicInfo und GetInlineFramesCount übergebene Flags.

Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.

DkmCompressionAlgorithmId

Gibt den Komprimierungsalgorithmus an, der für einen Bytespuffer verwendet wird. Dies kann verwendet werden, um zu bestimmen, welcher Algorithmus zum Dekomprimieren der Bytes verwendet werden soll.

Diese API wurde in Visual Studio 15 Update 5 (DkmApiVersion.VS15Update5) eingeführt.

DkmDocumentMatchStrength

Gibt an, wie stark eine Übereinstimmung zwischen der DkmDocumentQuery und dem resultierenden DkmResolvedDocument bestand.

DkmHashAlgorithmId

Bezeichner eines Hashalgorithmus, der zum Berechnen eines Hashs verwendet wird.

Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.

DkmInstructionSymbol.Tag

DkmInstructionSymbol ist eine abstrakte Basisklasse. Diese Aufzählung gibt an, welche abgeleitete Klasse dieses Objekt instance ist.

DkmModuleSymbolFlags

Flags, die Merkmale eines DkmModule-Objekts angeben.

Diese API wurde in Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) eingeführt.

DkmResolvedDocumentWarning

Warnung, die während der Übereinstimmung aufgetreten ist. Je nach Kontext müssen diese möglicherweise für den Benutzer angezeigt werden.

DkmSourcePositionFlags

Flags, die das Verhalten von "GetSourcePosition" beeinflussen.

DkmSteppingRangeBoundary

Gibt dem Symbolanbieter den Typ der Anweisungen an, die in die "No-Step"-Regionen eingeschlossen werden sollen.

DkmSymbolFileId.Tag

DkmSymbolFileId ist eine abstrakte Basisklasse. Diese Enumeration gibt an, welche abgeleitete Klasse dieses Objekt instance ist.

DkmSymbolLoadFlags

Flags, die sich auf das Verhalten von "TryLoadSymbols" auswirken.

Diese API wurde in Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) eingeführt.