Udostępnij za pośrednictwem

ICorDebugMetaDataLocator::GetMetaData — Metoda

  • Artykuł

Prosi debugera o zwrócenie pełnej ścieżki do modułu, którego metadane są potrzebne do ukończenia operacji żądanego debugera.

Składnia

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[]  
      );

Parametry

wszImagePath
[w] Ciąg o wartości null reprezentujący pełną ścieżkę do pliku. Jeśli pełna ścieżka jest niedostępna, nazwa i rozszerzenie pliku (nazwa pliku. rozszerzenie).

dwImageTimeStamp
[w] Sygnatura czasowa z nagłówków pliku PE obrazu. Ten parametr może być potencjalnie używany do wyszukiwania serwera symboli (SymSrv).

dwImageSize
[w] Rozmiar obrazu z nagłówków plików PE. Ten parametr może być potencjalnie używany do wyszukiwania SymSrv.

cchPathBuffer
[w] Liczba znaków w elemecie wszPathBuffer.

pcchPathBuffer
[out] Liczba znaków zapisanych WCHARw pliku wszPathBuffer.

Jeśli metoda zwróci E_NOT_SUFFICIENT_BUFFER, zawiera liczbę WCHARelementów wymaganych do przechowywania ścieżki.

wszPathBuffer
[out] Wskaźnik do buforu, do którego debuger skopiuje pełną ścieżkę pliku zawierającego żądane metadane.

Flaga ofReadOnly z wyliczenia CorOpenFlags służy do żądania dostępu tylko do odczytu do metadanych w tym pliku.

Wartość zwracana

Ta metoda zwraca następujące określone elementy HRESULTs, a także błędy HRESULT wskazujące niepowodzenie metody. Wszystkie inne błędy HRESULTs wskazują, że plik nie można pobrać.

HRESULT Opis
S_OK Metoda została ukończona pomyślnie. wszPathBuffer zawiera pełną ścieżkę do pliku i ma wartość null zakończoną.
E_NOT_SUFFICIENT_BUFFER Bieżący rozmiar nie jest wystarczający wszPathBuffer do przechowywania pełnej ścieżki. W tym przypadku pcchPathBuffer zawiera wymaganą liczbę WCHARs, w tym znak o wartości null zakończenia i GetMetaData jest wywoływany po raz drugi z żądanym rozmiarem buforu.

Uwagi

Jeśli wszImagePath zawiera pełną ścieżkę modułu ze zrzutu, określa ścieżkę z komputera, na którym został zebrany zrzut. Plik może nie istnieć w tej lokalizacji lub nieprawidłowy plik o tej samej nazwie może być przechowywany w ścieżce.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorDebug.idl, CorDebug.h

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od 4

Zobacz też