Metode IDebugFailureAnalysis2::SetString (extsfns.h)
Metode SetString mencari objek DebugFailureAnalysis untuk entri FA pertama yang memiliki tag yang ditentukan. Jika menemukan entri FA dengan tag yang ditentukan, ia mengatur (menimpa) blok data entri FA ke nilai string yang ditentukan. Jika metode ini tidak menemukan entri FA yang memiliki tag yang ditentukan, metode ini membuat entri FA baru dengan tag tersebut dan mengatur blok data entri FA baru ke nilai string yang ditentukan.
Sintaks
PFA_ENTRY SetString(
FA_TAG Tag,
[in] PCSTR Str
);
Parameter
Tag
Nilai dalam enumerasi FA_TAG .
[in] Str
Penunjuk ke string ANSI yang dihentikan null untuk ditulis ke blok data entri FA baru atau yang sudah ada.
Nilai kembali
Jika metode ini berhasil, metode ini mengembalikan penunjuk ke struktur FA_ENTRY baru atau yang sudah ada. Jika tidak, ia mengembalikan NULL.
Keterangan
Jika metode ini menemukan entri FA dengan tag yang ditentukan, metode ini memeriksa untuk melihat apakah jenis data yang terkait dengan tag tersebut DEBUG_FA_ENTRY_ANSI_STRING atau DEBUG_FA_ENTRY_EXTENSION_CMD. Jika jenis data yang terkait dengan tag bukan salah satu dari dua jenis tersebut, metode ini mengembalikan NULL dan tidak menimpa blok data entri.
Jika metode ini tidak menemukan entri FA dengan tag yang ditentukan, metode ini membuat entri FA baru dengan tag tersebut, dan mengaitkan tag dengan jenis data DEBUG_FA_ENTRY_ANSI_STRING.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | extsfns.h |