Partager via

ICorDebugMetaDataLocator ::GetMetaData, méthode

Demande au débogueur de retourner le chemin d’accès complet à un module dont les métadonnées sont nécessaires pour terminer 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, le nom et l’extension du fichier (nom de 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 WCHARs 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 est utilisé pour demander un accès en lecture seule aux métadonnées de ce fichier.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivantes ainsi que les erreurs HRESULT qui indiquent une défaillance de méthode. Toutes les autres défaillances HRESULT indiquent que le fichier n’est pas récupérable.

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

Remarques

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

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

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

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 4.0

Voir aussi

  • Last updated on