Share via

ICorDebugMetaDataLocator::GetMetaData, méthode

  • Article

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 le caractère 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 d'image dans les en-têtes de fichier PE. Ce paramètre peut potentiellement être utilisé pour une recherche SymSrv.

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

pcchPathBuffer
[out] Nombre de WCHAR é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 d’accès complet du fichier contenant 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

Voir aussi