SymAddSourceStreamW, fonction (dbghelp.h)

Article
11/20/2024

Ajoute le flux au module spécifié à utiliser par le serveur source .

Syntaxe

BOOL IMAGEAPI SymAddSourceStreamW(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
                 PCWSTR  FileSpec,
  [in, optional] PBYTE   Buffer,
  [in]           size_t  Size
);

Paramètres

[in] hProcess

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

[in] Base

Adresse de base du module.

FileSpec

Chaîne terminée par null qui contient le chemin absolu ou relatif d’un fichier qui contient le flux d’indexation source. Peut être NULL si de mémoire tampon n’est pas NULL.

[in, optional] Buffer

Mémoire tampon qui contient le flux d’indexation source. Peut être NULL si StreamFile n’est pas NULL.

[in] Size

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

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

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 de la mémoire tampon ou un fichier dans le paramètre StreamFile. Si les deux paramètres sont remplis, la fonction utilise le paramètre tampon . Si les deux paramètres sont NULL, la fonction retourne FALSE et le code dernière erreur est défini sur ERROR_INVALID_PARAMETER.

Il est important de noter que SymAddSourceStream n’ajoute pas le flux à une base de données PDB correspondante pour conserver les données. Cette fonction est utilisée par les personnes 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.

Note

L’en-tête dbghelp.h définit SymAddSourceStream 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.8 ou version ultérieure

Partager via