Método IDebugFailureAnalysis2::SetString (extsfns.h)
O método SetString pesquisa um objeto DebugFailureAnalysis para a primeira entrada fa que tem uma marca especificada. Se encontrar uma entrada FA com a marca especificada, ela definirá (substituirá) o bloco de dados da entrada FA para um valor de cadeia de caracteres especificado. Se esse método não encontrar uma entrada FA que tenha a marca especificada, ele criará uma nova entrada FA com essa marca e definirá o bloco de dados da nova entrada FA para o valor de cadeia de caracteres especificado.
Sintaxe
PFA_ENTRY SetString(
FA_TAG Tag,
[in] PCSTR Str
);
Parâmetros
Tag
Um valor na enumeração FA_TAG .
[in] Str
Um ponteiro para uma cadeia de caracteres ANSI terminada em nulo a ser gravada no bloco de dados da entrada FA nova ou existente.
Retornar valor
Se esse método for bem-sucedido, ele retornará um ponteiro para a estrutura de FA_ENTRY nova ou existente. Caso contrário, retornará NULL.
Comentários
Se esse método encontrar uma entrada FA com a marca especificada, ele verificará se o tipo de dados associado a essa marca é DEBUG_FA_ENTRY_ANSI_STRING ou DEBUG_FA_ENTRY_EXTENSION_CMD. Se o tipo de dados associado à marca não for um desses dois tipos, esse método retornará NULL e não substituirá o bloco de dados da entrada.
Se esse método não encontrar uma entrada FA com a marca especificada, ele criará uma nova entrada FA com essa marca e associará a marca ao tipo de dados DEBUG_FA_ENTRY_ANSI_STRING.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | extsfns.h |
Confira também
Gravando um plug-in de extensão de análise para estender !analisar