ICorDebugMetaDataLocator::GetMetaData, méthode

Article
11/05/2024

Indique au débogueur de retourner le chemin d’accès complet à un module dont les métadonnées sont nécessaires pour effectuer une opération demandée par le débogueur.

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

Paramètres

wszImagePath [in] Chaîne terminée par null qui représente le chemin d’accès complet au fichier. Si le chemin d’accès complet n’est pas disponible, nom et extension du fichier (nom_fichier.extension).

dwImageTimeStamp [in] Horodatage des en-têtes de fichier PE de l’image. Ce paramètre peut potentiellement être utilisé pour une recherche de serveur de symboles (SymSrv).

dwImageSize [in] Taille de l’image à partir des en-têtes de fichier PE. Ce paramètre peut potentiellement être utilisé pour une recherche SymSrv.

cchPathBuffer [in] Nombre de caractères en wszPathBuffer.

pcchPathBuffer [out] Nombre de WCHARs écrits dans wszPathBuffer.

Si la méthode retourne E_NOT_SUFFICIENT_BUFFER, contient le nombre de WCHAR nécessaires pour stocker le chemin d'accès.

wszPathBuffer [out] Pointeur vers une mémoire tampon dans laquelle le débogueur copie le chemin complet du fichier qui contient les métadonnées demandées.

L’indicateur ofReadOnly de l’énumération CorOpenFlags permet de demander l’accès en lecture seule aux métadonnées dans ce fichier.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l'échec de la méthode. Tous les autres HRESULT d'échec indiquent que le fichier n'est pas récupérable.

HRESULT	Description
S_OK	La commande s'est correctement terminée. `wszPathBuffer` contient le chemin d'accès complet au fichier et se termine par le caractère null.
E_NOT_SUFFICIENT_BUFFER	La taille actuelle de `wszPathBuffer` n’est pas suffisante pour contenir le chemin d’accès complet. Dans ce cas, `pcchPathBuffer` contient le nombre nécessaire de `WCHAR`, y compris le caractère null de fin, et la méthode `GetMetaData` est appelée une deuxième fois avec la taille de mémoire tampon demandée.

Notes

Si wszImagePath contient le chemin d’accès complet d’un module dans un dump, il spécifie le chemin d’accès de l’ordinateur sur lequel le dump a été collecté. Le fichier n'existe peut-être pas à cet emplacement ou un fichier incorrect portant le même nom peut être stocké dans le chemin d'accès.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Partager via