ICorDebugMetaDataLocator::GetMetaData – metoda

Požádá ladicí program, aby vrátil úplnou cestu k modulu, jehož metadata jsou potřebná k dokončení operace požadovaného ladicího programu.

Syntaxe

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 [v] Řetězec ukončený hodnotou null, který představuje úplnou cestu k souboru. Pokud úplná cesta není k dispozici, název a přípona souboru (název souboru).rozšíření).

dwImageTimeStamp [v] Časové razítko ze záhlaví souboru PE obrázku. Tento parametr lze potenciálně použít pro vyhledávání serveru symbolů (SymSrv).

dwImageSize [v] Velikost obrázku ze záhlaví souboru PE. Tento parametr lze potenciálně použít pro vyhledávání SymSrv.

cchPathBuffer [v] Počet znaků v wszPathBuffer.

pcchPathBuffer [ven] Počet zápisů WCHARdo wszPathBuffer.

Pokud metoda vrátí E_NOT_SUFFICIENT_BUFFER, obsahuje počet WCHARs potřebných k uložení cesty.

wszPathBuffer [ven] Ukazatel na vyrovnávací paměť, do které ladicí program zkopíruje úplnou cestu k souboru, který obsahuje požadovaná metadata.

Příznak ofReadOnly z výčtu CorOpenFlags se používá k vyžádání přístupu jen pro čtení k metadatům v tomto souboru.

Návratová hodnota

Tato metoda vrátí následující konkrétní HRESULTs a také chyby HRESULT, které označují selhání metody. Všechny ostatní chyby HRESULT značí, že soubor nelze načíst.

HRESULT	Description
S_OK	Metoda byla úspěšně dokončena. wszPathBuffer obsahuje úplnou cestu k souboru a je ukončena hodnotou null.
E_NOT_SUFFICIENT_BUFFER	Aktuální velikost wszPathBuffer není dostatečná k uložení celé cesty. V tomto případě pcchPathBuffer obsahuje potřebný počet WCHARs, včetně ukončujícího znaku null, a GetMetaData je volána podruhé s požadovanou velikost vyrovnávací paměti.

Poznámky

Pokud wszImagePath obsahuje úplnou cestu modulu z výpisu paměti, určuje cestu z počítače, kde se výpis paměti shromáždil. Soubor pravděpodobně v tomto umístění neexistuje nebo je možné, že v cestě bude uložen nesprávný soubor se stejným názvem.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Záhlaví: CorDebug.idl, CorDebug.h

Knihovna: CorGuids.lib

Verze .NET: K dispozici od rozhraní .NET Framework 4.0

Viz také

• ICorDebugThread4 – rozhraní