Microsoft.VisualStudio.Debugger.Symbols Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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. |