Compartilhar via


Método IDebugFailureAnalysis2::SetUlong (extsfns.h)

O método SetUlong 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 ULONG 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 ULONG especificado.

Sintaxe

PFA_ENTRY SetUlong(
       FA_TAG Tag,
  [in] ULONG  Value
);

Parâmetros

Tag

Um valor na enumeração FA_TAG .

[in] Value

O valor ULONG a ser gravado 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, ele 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 está DEBUG_FA_ENTRY_ULONG. Se o tipo de dados associado à marca não for DEBUG_FA_ENTRY_ULONG, 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_ULONG.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho extsfns.h

Confira também

AddUlong

IDebugFailureAnalysis2

Gravando um plug-in de extensão de análise para estender !analyze

_EFN_Analyze