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

Artigo
02/29/2024

O método AddString adiciona uma nova entrada FA a um objeto DebugFailureAnalysis e define o bloco de dados da entrada FA como uma cadeia de caracteres especificada.

Sintaxe

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

Parâmetros

Tag

Um valor na enumeração FA_TAG . O tipo de dados associado a essa marca deve ser DEBUG_FA_ENTRY_ANSI_STRING.

[in] Str

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

Retornar valor

Se esse método for bem-sucedido, ele retornará um ponteiro para a nova estrutura FA_ENTRY . Se esse método falhar, ele retornará NULL.

Comentários

Esse método define o membro DataSize da nova estrutura FA_ENTRY para o comprimento, em bytes, da cadeia de caracteres, incluindo o terminador NULL .

Cada marca é associada a um dos tipos de dados na enumeração FA_ENTRY_TYPE . Para determinar o tipo de dados associado a uma marca, chame o método GetType da interface IDebugFAEntryTags .

Para obter um ponteiro para uma interface IDebugFAEntryTags , chame o método GetDebugFATagControl da interface IDebugFailureAnalysis2 .