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

Artigo
08/07/2023

O método GetExpressionSyntaxNames retorna os nomes completos e abreviados de uma sintaxe de expressão.

Sintaxe

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 o índice da sintaxe da expressão. O índice deve estar entre zero e o número de sintaxes de expressão retornadas por GetNumberExpressionSyntaxes menos uma.

[out, optional] FullNameBuffer

Recebe o nome completo da sintaxe da expressão. Se FullNameBuffer for NULL, essas informações não serão retornadas.

[in] FullNameBufferSize

Especifica o tamanho, em caracteres, do buffer FullNameBuffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] FullNameSize

Recebe o tamanho, em caracteres, do nome completo da sintaxe da expressão. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se FullNameSize for NULL, essas informações não serão retornadas.

[out, optional] AbbrevNameBuffer

Recebe o nome abreviado da sintaxe da expressão. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se AbbrevNameBuffer for NULL, essas informações não serão retornadas.

[in] AbbrevNameBufferSize

Especifica o tamanho, em caracteres, do buffer AbbrevNameBufferSize. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] AbbrevNameSize

Recebe o tamanho, em caracteres, do nome abreviado da sintaxe da expressão. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se AbbrevNameSize for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, FullNameBufferSize ou AbbrevNameBufferSize era menor que o tamanho do respectivo nome de sintaxe de expressão e o nome foi truncado para caber dentro do buffer.

Comentários

Atualmente, há duas sintaxes de expressão, seus nomes completos são "expressões do Microsoft Assembler" e "expressões de origem C++". As sintaxes de expressão abreviadas correspondentes são "MASM" e "C++".