Fonction SymAddSourceStream (dbghelp.h)

Article
02/28/2024

Ajoute le flux au module spécifié pour une utilisation par le serveur source.

Syntaxe

BOOL IMAGEAPI SymAddSourceStream(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCSTR   StreamFile,
  [in, optional] PBYTE   Buffer,
  [in]           size_t  Size
);

Paramètres

[in] hProcess

Handle d’un processus. Ce handle doit avoir été précédemment passé à la fonction SymInitialize .

[in] Base

Adresse de base du module.

[in, optional] StreamFile

Chaîne terminée par null qui contient le chemin d’accès absolu ou relatif d’un fichier qui contient le flux d’indexation source. Peut avoir la valeur NULL si La mémoire tampon n’est pas NULL.

[in, optional] Buffer

Mémoire tampon qui contient le flux d’indexation source. Peut avoir la valeur NULL si StreamFile n’a pas la valeur NULL.

[in] Size

Taille, en octets, de la mémoire tampon .

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.

Remarques

SymAddSourceStream ajoute un flux de données mis en forme pour une utilisation par le serveur source à un module désigné. L’appelant peut passer le flux en tant que mémoire tampon dans le paramètre Buffer ou un fichier dans le paramètre StreamFile . Si les deux paramètres sont remplis, la fonction utilise le paramètre Buffer . Si les deux paramètres ont la valeur NULL, la fonction retourne FALSE et le code de dernière erreur est défini sur ERROR_INVALID_PARAMETER.

Il est important de noter que SymAddSourceStream n’ajoute pas le flux à un PDB correspondant afin de conserver les données. Cette fonction est utilisée par ceux qui implémentent par programmation leurs propres débogueurs dans les scénarios dans lesquels une base de données PDB n’est pas disponible.

Configuration requise

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

Partager via