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

Artigo
02/06/2025

O método SetString 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 um valor de cadeia de caracteres especificado. 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 como o valor de cadeia de caracteres especificado.

Sintaxe

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

Parâmetros

Tag

Um valor na enumeração FA_TAG.

[in] Str

Um ponteiro para uma cadeia de caracteres ANSI terminada em nulo a ser gravada no bloco de dados da entrada fa nova ou existente .

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_ANSI_STRING ou DEBUG_FA_ENTRY_EXTENSION_CMD. Se o tipo de dados associado à marca não for um desses dois tipos, 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_ANSI_STRING.