ICorDebugMetaDataLocator::GetMetaData-Methode

Artikel
08/10/2011

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.

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 auf NULL endende Zeichenfolge, die den vollständigen Pfad der Datei darstellt. Wenn der vollständige Pfad nicht verfügbar ist, der Name und die Erweiterung der Datei (Dateiname.Erweiterung).
dwImageTimeStamp
[in] Der Zeitstempel aus den PE-Datei-Headern des Images. Dieser Parameter kann für eine Symbolserversuche (SymSrv ) verwendet werden.
dwImageSize
[in] Die Imagegröße aus PE-Datei-Headern. Dieser Parameter kann für eine SymSrv-Suche verwendet werden.
cchPathBuffer
[in] Die Anzahl der Zeichen in wszPathBuffer.
pcchPathBuffer
[out] Die Anzahl der in wszPathBuffer geschriebenen WCHARs.

Wenn die Methode E_NOT_SUFFICIENT_BUFFER zurückgibt, enthält der Parameter die Anzahl der zum Speichern des Pfads erforderlichen WCHARs.
wszPathBuffer
[out] Zeiger auf einen Puffer, in den der Debugger den vollständigen Pfad der Datei kopiert, die die angeforderten Metadaten enthält.

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

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler für Methodenfehler zurück. Alle anderen HRESULTs mit Fehlern geben an, dass die Datei nicht abrufbar ist.

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

Hinweise

Wenn wszImagePath einen vollständigen Pfad für ein Modul aus einem Speicherimage enthält, gibt der Parameter den Pfad auf dem Computer an, auf dem das Speicherimage erfasst wurde. Die Datei ist möglicherweise an diesem Speicherort nicht vorhanden, oder unter dem Pfad ist eventuell eine falsche Datei mit dem gleichen Namen gespeichert.