Método IDebugFailureAnalysis::GetString (extsfns.h)

Artigo
02/29/2024

O método GetString pesquisa um objeto DebugFailureAnalysis para a primeira entrada FA que tem uma marca especificada. Se encontrar uma entrada FA com a marca especificada, ela obterá o valor da cadeia de caracteres ANSI do bloco de dados da entrada.

Sintaxe

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

Parâmetros

[in] Tag

Um valor na enumeração FA_TAG .

[out] Str

Um ponteiro para um buffer que recebe o valor da cadeia de caracteres do bloco de dados da entrada.

[in] MaxSize

O tamanho, em bytes, do buffer apontado por Str.

Retornar valor

Se esse método encontrar uma entrada FA com a marca especificada e se for bem-sucedido na obtenção do bloco de dados, ele retornará um ponteiro para a estrutura FA_ENTRY . Caso contrário, ele retornará NULL.

Comentários

Esse método copia uma cadeia de caracteres terminada em nulo do bloco de dados da entrada para o buffer apontado por Str. Esse método copia no máximo caracteres MaxSize , incluindo o terminador NULL.

Cada marca que já foi usada em um objeto DebugFailureAnalysis está 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 .

O uso apropriado desse método é obter o bloco de dados de uma entrada fa que tem um tipo de dados de DEBUG_FA_ENTRY_ANSI_STRING.