Metodo IDebugFailureAnalysis2::SetString (extsfns.h)

Articolo
02/06/2025

Il metodo SetString cerca un oggetto DebugFailureAnalysis il primo di immissione fa con un tag specificato. Se trova una voce FA con il tag specificato, imposta (sovrascrive) il blocco di dati della voce FA su un valore stringa specificato. Se questo metodo non trova una voce fa fa con il tag specificato, crea una nuova voce FA con tale tag e imposta il blocco di dati della nuova voce FA sul valore stringa specificato.

Sintassi

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

Parametri

Tag

Valore nell'enumerazione FA_TAG.

[in] Str

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

Valore restituito

Se questo metodo ha esito positivo, restituisce un puntatore alla struttura FA_ENTRY nuova o esistente. In caso contrario, restituisce NULL.

Osservazioni

Se questo metodo trova una voce fa con il tag specificato, verifica se il tipo di dati associato a tale tag è DEBUG_FA_ENTRY_ANSI_STRING o DEBUG_FA_ENTRY_EXTENSION_CMD. Se il tipo di dati associato al tag non è uno di questi due tipi, questo metodo restituisce NULL e non sovrascrive il blocco di dati della voce.

Se questo metodo non trova una voce FA con il tag specificato, crea una nuova voce FA con tale tag e associa il tag al tipo di dati DEBUG_FA_ENTRY_ANSI_STRING.