Metodo IDebugFailureAnalysis2::AddString (extsfns.h)

Articolo
02/29/2024

Il metodo AddString aggiunge una nuova voce FA a un oggetto DebugFailureAnalysis e imposta il blocco di dati della voce FA su una stringa specificata.

Sintassi

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

Parametri

Tag

Valore nell'enumerazione FA_TAG . Il tipo di dati associato a questo tag deve essere DEBUG_FA_ENTRY_ANSI_STRING.

[in] Str

Puntatore a una stringa ANSI con terminazione Null da scrivere nel blocco di dati della nuova voce FA.

Valore restituito

Se questo metodo ha esito positivo, restituisce un puntatore alla nuova struttura FA_ENTRY . Se questo metodo ha esito negativo, restituisce NULL.

Commenti

Questo metodo imposta il membro DataSize della nuova struttura FA_ENTRY sulla lunghezza, espressa in byte, della stringa che include il carattere di terminazione NULL .

Ogni tag è associato a uno dei tipi di dati nell'enumerazione FA_ENTRY_TYPE . Per determinare il tipo di dati associato a un tag, chiamare il metodo GetType dell'interfaccia IDebugFAEntryTags .

Per ottenere un puntatore a un'interfaccia IDebugFAEntryTags , chiamare il metodo GetDebugFATagControl dell'interfaccia IDebugFailureAnalysis2 .