Partager via


Fonction SymGetFileLineOffsets64 (dbghelp.h)

Recherche les informations de ligne pour le module et le nom de fichier spécifiés.

Syntaxe

ULONG IMAGEAPI SymGetFileLineOffsets64(
  [in]           HANDLE   hProcess,
  [in, optional] PCSTR    ModuleName,
  [in]           PCSTR    FileName,
  [out]          PDWORD64 Buffer,
  [in]           ULONG    BufferLines
);

Paramètres

[in] hProcess

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

[in, optional] ModuleName

Nom du module dans lequel les lignes doivent être localisées. Si ce paramètre a la valeur NULL, la fonction recherche tous les modules.

[in] FileName

Nom du fichier dans lequel les lignes doivent être localisées.

[out] Buffer

Tableau de décalages pour chaque ligne. Le décalage de la ligne n est stocké dans l’élément n-1. Les éléments tableaux pour les lignes qui n’ont pas d’informations de ligne sont laissés inchangés.

[in] BufferLines

Taille du tableau de mémoire tampon , en éléments.

Valeur retournée

Si la fonction réussit, la valeur de retour est le numéro de ligne le plus élevé trouvé. Cette valeur est égale à zéro si aucune information de ligne n’a été trouvée.

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

Remarques

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.

Configuration requise

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

Voir aussi

Fonctions DbgHelp