Método IDebugFailureAnalysis2::SetExtensionCommand (extsfns.h)

Artigo
02/06/2025

O método SetExtensionCommand pesquisa um objeto DebugFailureAnalysis para a primeira entrada fa que tem uma marca especificada. Se encontrar uma entrada FA com a marca especificada, ela definirá (substituirá) o bloco de dados da entrada FA para uma cadeia de caracteres de comando de extensão especificada. Se esse método não encontrar uma entrada fa que tenha a marca especificada, ele criará uma nova entrada FA com essa marca e definirá o bloco de dados da nova entrada fa para a cadeia de caracteres de comando de extensão especificada.

Sintaxe

PFA_ENTRY SetExtensionCommand(
  FA_TAG Tag,
  PCSTR  Extension
);

Parâmetros

Tag

Um valor na enumeração FA_TAG.

Extension

Um ponteiro para uma cadeia de caracteres terminada em nulo que é o comando de extensão. Um exemplo de um comando de extensão é "!analisar -v".

Valor de retorno

Se esse método for bem-sucedido, ele retornará um ponteiro para a estrutura de FA_ENTRY nova ou existente. Caso contrário, ele retornará NULL.

Observações

Se esse método encontrar uma entrada fa com a marca especificada, ele verificará se o tipo de dados associado a essa marca é DEBUG_FA_ENTRY_EXTENSION_CMD ou DEBUG_FA_ENTRY_ANSI_STRING. Se o tipo de dados associado à marca não tiver um desses dois valores, esse método retornará NULL e não substituirá o bloco de dados da entrada.

Se esse método não encontrar uma entrada fa com a marca especificada, ele criará uma nova entrada FA com essa marca e associará a marca ao tipo de dados DEBUG_FA_ENTRY_EXTENSION_CMD.