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

Artigo
02/06/2025

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

Sintaxe

HRESULT StartSymbolMatchWide(
  [in]  PCWSTR   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
S_OK	O método foi bem-sucedido.
E_NOINTERFACE	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)

Consulte também

EndSymbolMatch

GetNextSymbolMatch

IDebugSymbols3

Compartilhar via