Método IDebugSymbolGroup::OutputAsType (dbgeng.h)

Artigo
02/26/2024

O método OutputAsType altera o tipo de um símbolo em um grupo de símbolos. A entrada do símbolo é atualizada para representar o novo tipo.

Sintaxe

HRESULT OutputAsType(
  [in] ULONG Index,
  [in] PCSTR Type
);

Parâmetros

[in] Index

O índice da entrada neste grupo de símbolos. O índice de um símbolo é um número de identificação. O índice varia de zero até o número de símbolos no grupo de símbolos menos um.

[in] Type

O nome do tipo do símbolo desejado. Se o nome começar com um ponto de exclamação (!), o nome será tratado como uma extensão. Para obter mais informações sobre como usar uma extensão como um tipo, consulte a seção Comentários.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Esse método também pode retornar valores de erro. Para obter mais informações, consulte Valores retornados.

Comentários

Como os filhos do novo tipo de entrada podem ser diferentes dos filhos do tipo de entrada antigo, o método OutputAsType remove todos os filhos da entrada do grupo de símbolos. Você pode adicionar os filhos de volta usando o método ExpandSymbol .

Se Type for uma extensão, o endereço do símbolo será passado para a extensão. Cada linha de saída da extensão se torna um símbolo filho do símbolo especificado. Esses símbolos filho são texto e você não pode manipulá-los de forma alguma. Por exemplo, se o nome de uma variável for @$teb, você poderá alterar seu tipo para !teb.

Para obter mais informações sobre grupos de símbolos, consulte Escopos e grupos de símbolos.