Methode ICorDebugMetaDataLocator::GetMetaData

Artikel
04/08/2023

Vraagt het foutopsporingsprogramma om het volledige pad te retourneren naar een module waarvan de metagegevens nodig zijn om een bewerking te voltooien die door het foutopsporingsprogramma is aangevraagd.

Syntaxis

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

Parameters

wszImagePath
[in] Een tekenreeks met een null-einde die het volledige pad naar het bestand vertegenwoordigt. Als het volledige pad niet beschikbaar is, de naam en extensie van het bestand (bestandsnaam. extensie).

dwImageTimeStamp
[in] De tijdstempel van de PE-bestandsheaders van de afbeelding. Deze parameter kan mogelijk worden gebruikt voor het opzoeken van symboolservers (SymSrv).

dwImageSize
[in] De afbeeldingsgrootte van PE-bestandsheaders. Deze parameter kan mogelijk worden gebruikt voor een SymSrv-zoekopdracht.

cchPathBuffer
[in] Het aantal tekens in wszPathBuffer.

pcchPathBuffer
[uit] Het aantal WCHARs dat is geschreven naar wszPathBuffer.

Als de methode E_NOT_SUFFICIENT_BUFFER retourneert, bevat het aantal WCHARs dat nodig is om het pad op te slaan.

wszPathBuffer
[uit] Aanwijzer naar een buffer waarin het foutopsporingsprogramma het volledige pad van het bestand met de aangevraagde metagegevens kopieert.

De ofReadOnly vlag van de opsomming CorOpenFlags wordt gebruikt om alleen-lezentoegang aan te vragen tot de metagegevens in dit bestand.

Retourwaarde

Deze methode retourneert de volgende specifieke HRESULT's en HRESULT-fouten die wijzen op een fout in de methode. Alle andere fout-HRESULT's geven aan dat het bestand niet kan worden opgehaald.

HRESULT	Beschrijving
S_OK	De methode is voltooid. `wszPathBuffer` bevat het volledige pad naar het bestand en is beëindigd op null.
E_NOT_SUFFICIENT_BUFFER	De huidige grootte van `wszPathBuffer` is niet voldoende om het volledige pad vast te houden. In dit geval `pcchPathBuffer` bevat het benodigde aantal `WCHAR`s, inclusief het afsluitende null-teken, en `GetMetaData` wordt een tweede keer aangeroepen met de aangevraagde buffergrootte.

Opmerkingen

Als wszImagePath een volledig pad voor een module van een dump bevat, wordt het pad opgegeven vanaf de computer waarop de dump is verzameld. Het bestand bestaat mogelijk niet op deze locatie of er is een onjuist bestand met dezelfde naam opgeslagen op het pad.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 4

Delen via