Delen via

Methode ICorDebugMetaDataLocator::GetMetaData

Vraagt het foutopsporingsprogramma om het volledige pad te retourneren naar een module waarvan de metagegevens nodig zijn om een bewerking te voltooien die het aangevraagde foutopsporingsprogramma heeft uitgevoerd.

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

Parameterwaarden

wszImagePath [in] Een door null beëindigde tekenreeks die het volledige pad naar het bestand vertegenwoordigt. Als het volledige pad niet beschikbaar is, wordt de naam en extensie van het bestand (bestandsnaam) gebruikt.extensie).

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

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

cchPathBuffer [in] Het aantal tekens in wszPathBuffer.

pcchPathBuffer [uit] Het aantal WCHARgeschreven 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] Wijs een buffer aan 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 tot de metagegevens in dit bestand aan te vragen.

Retourwaarde

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

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

Opmerkingen

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

Requirements

Platformen: Zie ondersteunde besturingssystemen van .NET.

Rubriek: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET-versies: Beschikbaar sinds .NET Framework 4.0

Zie ook

  • Last updated on