Método IDebugSymbols2::GetNextSymbolMatch (dbgeng.h)

Artigo
08/07/2023

O método GetNextSymbolMatch retorna o próximo símbolo encontrado em uma pesquisa de símbolos.

Sintaxe

HRESULT GetNextSymbolMatch(
  [in]            ULONG64  Handle,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

Parâmetros

[in] Handle

Especifica o identificador retornado por StartSymbolMatch quando a pesquisa foi inicializada.

[out, optional] Buffer

Recebe o nome do símbolo. Se Buffer for NULL, o mesmo símbolo será retornado novamente na próxima vez que um desses métodos for chamado (com o mesmo identificador); isso pode ser usado para determinar o tamanho do nome do símbolo.

[in] BufferSize

Especifica o tamanho em caracteres do buffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] MatchSize

Recebe o tamanho em caracteres do nome do símbolo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se MatchSize for NULL, essas informações não serão retornadas.

[out, optional] Offset

Recebe o local no espaço de endereço virtual do símbolo do destino. Se Offset for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O tamanho do buffer era muito pequeno para o nome do símbolo ou Buffer era NULL.
E_NOINTERFACE	Não foram encontrados mais símbolos que correspondam ao padrão.

Comentários

A pesquisa deve primeiro ser inicializada por StartSymbolMatch. Depois que todos os símbolos desejados forem encontrados, EndSymbolMatch poderá ser usado para liberar os recursos que o mecanismo contém para a pesquisa.

Para obter mais informações sobre símbolos, consulte Símbolos.