Método IDebugSymbols2::StartSymbolMatch (dbgeng.h)
O método StartSymbolMatch inicializa uma pesquisa por 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 da sintaxe do padrão, consulte sintaxe de símbolo e de correspondência de símbolos e sintaxe curinga da cadeia de caracteres .
[out] Handle
Recebe o identificador que identifica a pesquisa. Esse identificador pode ser passado para GetNextSymbolMatch e EndSymbolMatch.
Valor de retorno
Esse método também pode retornar outros valores de erro. Consulte de Valores Retornados para obter mais detalhes.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
O módulo especificado não foi encontrado. |
Observações
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 contém para a pesquisa.
Para obter mais informações sobre símbolos, consulte Symbols.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |