Méthode IDebugSymbols3 ::AddSyntheticSymbol (dbgeng.h)

Article
02/26/2024

La méthode AddSyntheticSymbol ajoute un symbole synthétique à un module dans le processus actuel.

Syntaxe

HRESULT AddSyntheticSymbol(
  [in]            ULONG64              Offset,
  [in]            ULONG                Size,
  [in]            PCSTR                Name,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Id
);

Paramètres

[in] Offset

Spécifie l’emplacement dans l’espace d’adressage virtuel du processus du symbole synthétique.

[in] Size

Spécifie la taille en octets du symbole synthétique.

[in] Name

Spécifie le nom du symbole synthétique.

[in] Flags

Définissez sur DEBUG_ADDSYNTHSYM_DEFAULT.

[out, optional] Id

Reçoit la structure DEBUG_MODULE_AND_ID qui identifie le symbole synthétique. Si ID a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Remarques

L’emplacement du symbole synthétique ne doit pas être identique à celui d’un autre symbole.

Si le module contenant un symbole synthétique est rechargé (par exemple, en appelant Reload avec le paramètre Module défini sur le nom du module), le symbole synthétique est ignoré.

Pour plus d’informations sur les symboles synthétiques, consultez Symboles synthétiques.