Fonction SymGetLineFromInlineContext (dbghelp.h)

Article
08/23/2023

Recherche la ligne source pour le contexte inline spécifié.

Syntaxe

BOOL IMAGEAPI SymGetLineFromInlineContext(
  [in]           HANDLE           hProcess,
  [in]           DWORD64          qwAddr,
  [in]           ULONG            InlineContext,
  [in, optional] DWORD64          qwModuleBaseAddress,
  [out]          PDWORD           pdwDisplacement,
  [out]          PIMAGEHLP_LINE64 Line64
);

Paramètres

[in] hProcess

Handle du processus qui a été passé à l’origine à la fonction SymInitialize .

[in] qwAddr

Adresse pour laquelle une ligne doit se trouver. Il n’est pas nécessaire que l’adresse se trouve sur une limite de ligne. Si l’adresse apparaît après le début d’une ligne et avant la fin de la ligne, la ligne est trouvée.

[in] InlineContext

Contexte inline.

[in, optional] qwModuleBaseAddress

Adresse de base du module.

[out] pdwDisplacement

Déplacement en octets à partir du début de la ligne, ou zéro.

[out] Line64

Pointeur vers une structure IMAGEHLP_LINE64 .

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Notes

L’appelant doit allouer correctement la mémoire tampon de ligne et renseigner les membres requis de la structure IMAGEHLP_LINE64 avant d’appeler SymGetLineFromInlineContext.

Cette fonction retourne un pointeur vers une mémoire tampon qui peut être réutilisée par une autre fonction. Par conséquent, veillez à copier immédiatement les données retournées dans une autre mémoire tampon.

Toutes les fonctions DbgHelp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Pour appeler la version Unicode de cette fonction, définissez DBGHELP_TRANSLATE_TCHAR. SymGetLineFromInlineContext est défini comme suit dans Dbghelp.h.

BOOL
IMAGEAPI
SymGetLineFromInlineContextW(
    _In_ HANDLE hProcess,
    _In_ DWORD64 dwAddr,
    _In_ ULONG InlineContext,
    _In_opt_ DWORD64 qwModuleBaseAddress,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
 #define SymGetLineFromInlineContext SymGetLineFromInlineContextW
#endif

Spécifications


Plateforme cible	Windows
En-tête	dbghelp.h
Bibliothèque	DbgHelp.lib
DLL	DbgHelp.dll
Composant redistribuable	DbgHelp.dll 6.2 ou version ultérieure

Partager via