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

Artículo
02/23/2024

El método GetExpressionSyntaxNames devuelve los nombres completos y abreviados de una sintaxis de expresión.

Sintaxis

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
);

Parámetros

[in] Index

Especifica el índice de la sintaxis de expresión. El índice debe estar entre cero y el número de sintaxis de expresión devueltas por GetNumberExpressionSyntaxes menos uno.

[out, optional] FullNameBuffer

Recibe el nombre completo de la sintaxis de la expresión. Si FullNameBuffer es NULL, esta información no se devuelve.

[in] FullNameBufferSize

Especifica el tamaño, en caracteres, del búfer FullNameBuffer. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] FullNameSize

Recibe el tamaño, en caracteres, del nombre completo de la sintaxis de expresión. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si FullNameSize es NULL, no se devuelve esta información.

[out, optional] AbbrevNameBuffer

Recibe el nombre abreviado de la sintaxis de expresión. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si AbbrevNameBuffer es NULL, esta información no se devuelve.

[in] AbbrevNameBufferSize

Especifica el tamaño, en caracteres, del búfer AbbrevNameBufferSize. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] AbbrevNameSize

Recibe el tamaño, en caracteres, del nombre abreviado de la sintaxis de expresión. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si AbbrevNameSize es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, FullNameBufferSize o AbbrevNameBufferSize era menor que el tamaño del nombre de sintaxis de expresión correspondiente y el nombre se truncaba para caber dentro del búfer.

Comentarios

Actualmente, hay dos sintaxis de expresión, sus nombres completos son "Expresiones de ensamblador de Microsoft" y "Expresiones de origen de C++". Las sintaxis de expresión abreviadas correspondientes son "MASM" y "C++".