SymGetLineFromInlineContextW, fonction (dbghelp.h)

Article
11/20/2024

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

Syntaxe

BOOL IMAGEAPI SymGetLineFromInlineContextW(
  [in]           HANDLE            hProcess,
  [in]           DWORD64           dwAddr,
  [in]           ULONG             InlineContext,
  [in, optional] DWORD64           qwModuleBaseAddress,
  [out]          PDWORD            pdwDisplacement,
  [out]          PIMAGEHLP_LINEW64 Line
);

Paramètres

[in] hProcess

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

[in] dwAddr

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] Line

Pointeur vers une structure IMAGEHLP_LINE64.

Valeur de retour

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.

Remarques

L’appelant doit allouer correctement la mémoire tampon Line et remplir correctement 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, comme celle-ci, sont monothread. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement une altération inattendue du comportement ou 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

Note

L’en-tête dbghelp.h définit SymGetLineFromInlineContext comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	dbghelp.h
bibliothèque	DbgHelp.lib
DLL	DbgHelp.dll
redistribuable	DbgHelp.dll 6.2 ou version ultérieure

Partager via