ICorDebugMetaDataLocator::GetMetaData-Methode

Artikel
11/05/2024

Fordert den Debugger auf, den vollständigen Pfad eines Moduls zurückzugeben, dessen Metadaten benötigt werden, um einen vom Debugger angeforderten Vorgang abzuschließen.

Syntax

HRESULT GetMetaData(
      [in] LPCWSTR wszImagePath,
      [in] DWORD   dwImageTimeStamp,
      [in] DWORD   dwImageSize,
      [in] ULONG32 cchPathBuffer,
      [out] ULONG32 * pcchPathBuffer,
      [out, size_is(cchPathBuffer), length_is(*pcchPathBuffer)]
               WCHAR wszPathBuffer[]
      );

Parameter

wszImagePath [in] Eine mit Null beendete Zeichenfolge, die den vollständigen Pfad zur Datei darstellt. Wenn der vollständige Pfad nicht verfügbar ist, sind dies Name und Erweiterung der Datei (Dateiname.Erweiterung).

dwImageTimeStamp [in] Der Zeitstempel aus den PE-Dateiheadern des Bilds. Dieser Parameter kann potenziell für einen Symbolserver-Lookup (SymSrv) verwendet werden.

dwImageSize [in] Die Bildgröße aus PE-Dateiheadern. Dieser Parameter kann potenziell für eine SymSrv-Suche verwendet werden.

cchPathBuffer [in] Die Zeichenanzahl in wszPathBuffer.

pcchPathBuffer [out] Die Anzahl der WCHARin wszPathBuffer.

Wenn die Methode E_NOT_SUFFICIENT_BUFFER zurückgibt, ist die Anzahl der WCHARs enthalten, die zum Speichern des Pfads erforderlich ist.

wszPathBuffer [out] Zeigen Sie auf einen Puffer, in den der Debugger den vollständigen Pfad der Datei kopiert, die die angeforderten Metadaten enthält.

Das ofReadOnly-Flag aus der CorOpenFlags-Enumeration wird dazu verwendet, den schreibgeschützten Zugriff auf die Metadaten in dieser Datei anzufordern.

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler zurück, die Methodenfehler anzeigen. Alle anderen Fehler-HRESULTs geben an, dass die Datei nicht abgerufen werden kann.

HRESULT	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen. `wszPathBuffer` enthält den vollständigen Pfad zu der Datei und endet auf NULL.
E_NOT_SUFFICIENT_BUFFER	Die aktuelle Größe von `wszPathBuffer` reicht nicht aus, um den vollständigen Pfad aufzunehmen. In diesem Fall enthält `pcchPathBuffer` die benötigte Anzahl von `WCHAR`s, einschließlich des abschließenden NULL-Zeichens, und `GetMetaData` wird ein zweites Mal mit der angeforderten Puffergröße aufgerufen.

Bemerkungen

Wenn wszImagePath einen vollständigen Pfad für ein Modul aus einem Speicherabbild enthält, gibt es den Pfad von dem Computer an, auf dem das Speicherabbild erfasst wurde. Die Datei ist an diesem Speicherort möglicherweise nicht vorhanden, oder es wird eine falsche Datei mit gleichem Namen in diesem Pfad gespeichert.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit Version 4 verfügbar

Freigeben über