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

Artigo
02/06/2025

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

Sintaxe

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 o índice da sintaxe de expressã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 de 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 de expressão. Se AbbrevNameBuffer estiver 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 de 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.

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de 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 nome da sintaxe de expressão respectiva e o nome foi truncado para caber dentro do buffer.

Observações

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++".

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

Avaliar

GetNumberExpressionSyntaxes

IDebugControl4

SetExpressionSyntaxByName

Compartilhar via