Partager via


ISymUnmanagedWriter::GetDebugInfo, méthode

Retourne les informations nécessaires à un compilateur pour écrire l’entrée de répertoire de débogage dans l’en-tête du fichier exécutable portable (PE, portable executable). Le writer de symboles remplit tous les champs à l’exception de TimeDateStamp et PointerToRawData. (Le compilateur est chargé de définir ces deux champs de manière appropriée.)

Un compilateur doit appeler cette méthode, émettre l’objet blob de données dans le fichier PE, définir le champ PointerToRawData dans IMAGE_DEBUG_DIRECTORY pour qu’il pointe vers les données émises et écrire IMAGE_DEBUG_DIRECTORY dans le fichier PE. Le compilateur doit également définir le champ TimeDateStamp pour qu’il corresponde au TimeDateStamp du fichier PE en cours de génération.

Syntaxe

HRESULT GetDebugInfo(  
    [in, out] IMAGE_DEBUG_DIRECTORY *pIDD,  
    [in]  DWORD cData,  
    [out] DWORD *pcData,  
    [out, size_is(cData),  
        length_is(*pcData)] BYTE data[]);  

Paramètres

pIDD
[in, out] Pointeur vers un IMAGE_DEBUG_DIRECTORY, qui sera rempli par le writer de symboles.

cData
[in] DWORD qui contient la taille des données de débogage.

pcData
[out] Pointeur vers un DWORD, qui reçoit la taille de la mémoire tampon nécessaire pour contenir les données de débogage.

data
[out] Pointeur vers une mémoire tampon suffisamment grande pour contenir les données de débogage pour le magasin de symboles.

Valeur renvoyée

S_OK en cas de réussite de la méthode ; sinon, E_FAIL ou un autre code d’erreur.

Configuration requise

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

Voir aussi