Metodo IDebugFailureAnalysis::GetString (extsfns.h)
Il metodo GetString cerca un oggetto DebugFailureAnalysis per la prima voce FA con un tag specificato. Se trova una voce FA con il tag specificato, ottiene il valore della stringa ANSI dal blocco di dati della voce.
Sintassi
PFA_ENTRY GetString(
[in] FA_TAG Tag,
[out] PSTR Str,
[in] ULONG MaxSize
);
Parametri
[in] Tag
Valore nell'enumerazione FA_TAG .
[out] Str
Puntatore a un buffer che riceve il valore stringa dal blocco di dati della voce.
[in] MaxSize
Dimensione, in byte, del buffer a cui punta Str.
Valore restituito
Se questo metodo trova una voce FA con il tag specificato e se riesce a ottenere il blocco di dati, restituisce un puntatore alla struttura FA_ENTRY . In caso contrario, restituisce NULL.
Commenti
Questo metodo copia una stringa con terminazione Null dal blocco di dati della voce al buffer a cui punta Str. Questo metodo copia al massimo i caratteri MaxSize , incluso il carattere di terminazione NULL.
Ogni tag già utilizzato in un oggetto DebugFailureAnalysis è 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 .
L'uso appropriato di questo metodo è ottenere il blocco di dati da una voce FA con un tipo di dati di DEBUG_FA_ENTRY_ANSI_STRING.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | extsfns.h |
Vedi anche
Scrittura di un plug-in di estensione di analisi per estendere !analyze