IDebugControl3 ::GetExpressionSyntaxNames, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetExpressionSyntaxNames retourne les noms complets et abrégés d’une syntaxe d’expression.

Syntaxe

HRESULT GetExpressionSyntaxNames(
  [in]            ULONG  Index,
  [out, optional] PSTR   FullNameBuffer,
  [in]            ULONG  FullNameBufferSize,
  [out, optional] PULONG FullNameSize,
  [out, optional] PSTR   AbbrevNameBuffer,
  [in]            ULONG  AbbrevNameBufferSize,
  [out, optional] PULONG AbbrevNameSize
);

Paramètres

[in] Index

Spécifie l’index de la syntaxe d’expression. index doit être compris entre zéro et le nombre de syntaxes d’expression retournées par GetNumberExpressionSyntaxes moins un.

[out, optional] FullNameBuffer

Reçoit le nom complet de la syntaxe d’expression. Si FullNameBuffer est NULL, ces informations ne sont pas retournées.

[in] FullNameBufferSize

Spécifie la taille, en caractères, de la mémoire tampon FullNameBuffer. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] FullNameSize

Reçoit la taille, en caractères, du nom complet de la syntaxe d’expression. Cette taille inclut l’espace du caractère de fin « \0 ». Si FullNameSize est NULL, ces informations ne sont pas retournées.

[out, optional] AbbrevNameBuffer

Reçoit le nom abrégé de la syntaxe d’expression. Cette taille inclut l’espace du caractère de fin « \0 ». Si AbbrevNameBuffer est NULL, ces informations ne sont pas retournées.

[in] AbbrevNameBufferSize

Spécifie la taille, en caractères, de la mémoire tampon AbbrevNameBufferSize. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] AbbrevNameSize

Reçoit la taille, en caractères, du nom abrégé de la syntaxe d’expression. Cette taille inclut l’espace du caractère de fin « \0 ». Si AbbrevNameSize est NULL, ces informations ne sont pas retournées.

Valeur de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, FullNameBufferSize ou AbbrevNameBufferSize était plus petit que la taille du nom de syntaxe d’expression respectif, et le nom était tronqué pour s’adapter à l’intérieur de la mémoire tampon.

Remarques

Actuellement, il existe deux syntaxes d’expression, leurs noms complets sont « Expressions Assembleur Microsoft » et « Expressions sources C++ ». Les syntaxes d’expression abrégées correspondantes sont « MASM » et « C++ ».