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

Artículo
08/07/2023

El método GetNextSymbolMatch devuelve el símbolo siguiente que se encuentra en una búsqueda de símbolos.

Sintaxis

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 el identificador devuelto por StartSymbolMatch cuando se inicializó la búsqueda.

[out, optional] Buffer

Recibe el nombre del símbolo. Si Buffer es NULL, se devolverá de nuevo el mismo símbolo la próxima vez que se llame a uno de estos métodos (con el mismo identificador); se puede usar para determinar el tamaño del nombre del símbolo.

[in] BufferSize

Especifica el tamaño en caracteres del búfer. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] MatchSize

Recibe el tamaño en caracteres del nombre del símbolo. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si MatchSize es NULL, esta información no se devuelve.

[out, optional] Offset

Recibe la ubicación en el espacio de direcciones virtuales del destino del símbolo. Si Offset es NULL, esta información no se devuelve.

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.
S_FALSE	El tamaño del búfer era demasiado pequeño para el nombre del símbolo o el búfer era NULL.
E_NOINTERFACE	No se encontraron más símbolos que coincidan con el patrón.

Comentarios

La búsqueda debe inicializarse primero por StartSymbolMatch. Una vez encontrados todos los símbolos deseados, EndSymbolMatch se puede usar 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.