Método IDebugDataSpaces::SearchVirtual (dbgeng.h)

Artículo
02/23/2024

El método SearchVirtual busca en la memoria virtual del destino un patrón de bytes especificado.

Sintaxis

HRESULT SearchVirtual(
  [in]  ULONG64  Offset,
  [in]  ULONG64  Length,
  [in]  PVOID    Pattern,
  [in]  ULONG    PatternSize,
  [in]  ULONG    PatternGranularity,
  [out] PULONG64 MatchOffset
);

Parámetros

[in] Offset

Especifica la ubicación en el espacio de direcciones virtuales del destino para empezar a buscar el patrón.

[in] Length

Especifica hasta dónde buscar el patrón. Una coincidencia correcta requiere que se encuentre todo el patrón antes de que se examinen los bytes de longitud .

[in] Pattern

Especifica el patrón que se va a buscar.

[in] PatternSize

Especifica el tamaño en bytes del patrón. Debe ser un múltiplo de la granularidad del patrón.

[in] PatternGranularity

Especifica la granularidad del patrón. Para una coincidencia correcta, el patrón debe producirse un múltiplo de este valor después de la ubicación de inicio.

[out] MatchOffset

Recibe la ubicación en el espacio de direcciones virtuales del patrón, si se encontró.

Valor devuelto

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

Código devuelto	Descripción
S_OK	Método realizado correctamente.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Después de examinar Bytes de longitud , no se encontró el patrón.

Comentarios

Este método busca en la memoria virtual del destino la primera aparición, sujeta a granularidad, del patrón incluido completamente en los bytes length de la memoria del destino a partir del desplazamiento de ubicación.

PatternGranularity se puede usar para garantizar la alineación de la coincidencia con respecto a Offset. Por ejemplo, se puede usar un valor de 0x4 para requerir la alineación con un DWORD. Se puede usar un valor de 0x1 para permitir que el patrón comience en cualquier lugar.

Para obtener opciones adicionales, incluida la capacidad de restringir la búsqueda a la memoria grabable, consulte SearchVirtual2.