Método IDebugControl4::GetExpressionSyntaxNamesWide (dbgeng.h)

Artículo
08/07/2023

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

Sintaxis

HRESULT GetExpressionSyntaxNamesWide(
  [in]            ULONG  Index,
  [out, optional] PWSTR  FullNameBuffer,
  [in]            ULONG  FullNameBufferSize,
  [out, optional] PULONG FullNameSize,
  [out, optional] PWSTR  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, esta información no se devuelve.

[out, optional] AbbrevNameBuffer

Recibe el nombre abreviado de la sintaxis de expresión. 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 Microsoft Assembler" y "Expresiones de origen de C++". Las sintaxis de expresiones abreviadas correspondientes son "MASM" y "C++".