Método IDebugSymbols3::GetNextSymbolMatchWide (dbgeng.h)
El método GetNextSymbolMatchWide devuelve el siguiente símbolo que se encuentra en una búsqueda de símbolos.
Sintaxis
HRESULT GetNextSymbolMatchWide(
[in] ULONG64 Handle,
[out, optional] PWSTR 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 de búfer es NULL, el mismo símbolo se devolverá de nuevo 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, no se devuelve esta información.
[out, optional] Offset
Recibe la ubicación en el espacio de direcciones virtuales del destino del símbolo. Si desplazamiento es null, no se devuelve esta información.
Valor devuelto
Este método también puede devolver otros valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El tamaño del búfer era demasiado pequeño para el nombre del símbolo o Búfer era NULL. |
|
No se encontraron más símbolos que coincidan con el patrón. |
Observaciones
La búsqueda debe inicializarse primero 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.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |