ICorDebugMetaDataLocator::GetMetaData-metod

Artikel
11/05/2024

Ber felsökaren att returnera den fullständiga sökvägen till en modul vars metadata behövs för att slutföra en åtgärd som felsökningsprogrammet begärde.

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

Parametrar

wszImagePath [i] En null-avslutad sträng som representerar den fullständiga sökvägen till filen. Om den fullständiga sökvägen inte är tillgänglig, namnet och tillägget för filen (filnamn.filnamnstillägget).

dwImageTimeStamp [i] Tidsstämpeln från bildens PE-filhuvuden. Den här parametern kan potentiellt användas för en symbolserversökning (SymSrv).

dwImageSize [i] Bildstorleken från PE-filrubriker. Den här parametern kan potentiellt användas för en SymSrv-sökning.

cchPathBuffer [i] Teckenantalet i wszPathBuffer.

pcchPathBuffer [ut] Antalet WCHARs som skrivits till wszPathBuffer.

Om metoden returnerar E_NOT_SUFFICIENT_BUFFER innehåller antalet WCHARs som behövs för att lagra sökvägen.

wszPathBuffer [ut] Pekare till en buffert där felsökaren kopierar den fullständiga sökvägen till filen som innehåller de begärda metadata.

Flaggan ofReadOnly från CorOpenFlags-uppräkningen används för att begära skrivskyddad åtkomst till metadata i den här filen.

Returvärde

Den här metoden returnerar följande specifika HRESULT-fel samt HRESULT-fel som indikerar metodfel. Alla andra HRESULT-fel indikerar att filen inte kan hämtas.

HRESULT	beskrivning
S_OK	Metoden har slutförts. `wszPathBuffer` innehåller den fullständiga sökvägen till filen och är null-avslutad.
E_NOT_SUFFICIENT_BUFFER	Den aktuella storleken `wszPathBuffer` på räcker inte för att hålla den fullständiga sökvägen. I det här fallet `pcchPathBuffer` innehåller det nödvändiga antalet `WCHAR`s, inklusive det avslutande null-tecknet, och `GetMetaData` anropas en andra gång med den begärda buffertstorleken.

Kommentarer

Om wszImagePath innehåller en fullständig sökväg för en modul från en dump anger den sökvägen från datorn där dumpen samlades in. Filen kanske inte finns på den här platsen, eller så kan en felaktig fil med samma namn lagras på sökvägen.

Krav

Plattformar: Se Systemkrav.

Rubrik: CorDebug.idl, CorDebug.h

Bibliotek: CorGuids.lib

.NET Framework-versioner: Finns sedan 4

Dela via