Método IDebugSymbols3::StartSymbolMatch (dbgeng.h)

Artigo
02/23/2024

O método StartSymbolMatch inicializa uma pesquisa de símbolos cujos nomes correspondem a um determinado padrão.

Sintaxe

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

Parâmetros

[in] Pattern

Especifica o padrão para o qual pesquisar. A pesquisa retornará todos os símbolos cujos nomes correspondem a esse padrão. Para obter detalhes sobre a sintaxe do padrão, consulte Sintaxe de símbolo e correspondência de símbolos e sintaxe curinga de cadeia de caracteres.

[out] Handle

Recebe o identificador que identifica a pesquisa. Esse identificador pode ser passado para GetNextSymbolMatch e EndSymbolMatch.

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.
E_NOINTERFACE	O módulo especificado não foi encontrado.

Comentários

Esse método inicializa uma pesquisa de símbolos. Os resultados da pesquisa podem ser obtidos por chamadas repetidas para GetNextSymbolMatch. Quando todos os resultados desejados forem encontrados, use EndSymbolMatch para liberar recursos que o mecanismo mantém para a pesquisa.

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