Méthode IDebugControl3 ::GetExpressionSyntaxNames (dbgeng.h)

Article
02/26/2024

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. L’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 a la valeur 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 pour le 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 pour le caractère de fin « \0 ». Si FullNameSize a la valeur 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 pour le caractère de fin « \0 ». Si AbbrevNameBuffer a la valeur 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 pour le 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 pour le caractère de fin « \0 ». Si AbbrevNameSize a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, FullNameBufferSize ou AbbrevNameBufferSize était inférieur à la taille du nom de syntaxe d’expression respectif, et le nom a été tronqué pour s’adapter à la mémoire tampon.

Remarques

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