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

Artículo
08/07/2023

El método StartSymbolMatch inicializa una búsqueda de símbolos cuyos nombres coinciden con un patrón determinado.

Sintaxis

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

Parámetros

[in] Pattern

Especifica el patrón para el que se va a buscar. La búsqueda devolverá todos los símbolos cuyos nombres coincidan con este patrón. Para obtener más información sobre la sintaxis del patrón, vea Sintaxis de símbolos y Coincidencia de símbolos y Sintaxis de caracteres comodín de cadena.

[out] Handle

Recibe el identificador que identifica la búsqueda. Este identificador se puede pasar a GetNextSymbolMatch y EndSymbolMatch.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_NOINTERFACE	No se encontró el módulo especificado.

Comentarios

Este método inicializa una búsqueda de símbolos. Los resultados de la búsqueda se pueden obtener mediante llamadas repetidas a GetNextSymbolMatch. Cuando se hayan encontrado todos los resultados deseados, use EndSymbolMatch para liberar los recursos que contiene el motor para la búsqueda.

Para obtener más información sobre los símbolos, vea Símbolos.