Método IDebugDataSpaces3::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 cuánto se va a buscar el patrón. Una coincidencia correcta requiere que se encuentre todo el patrón antes de que se hayan examinado 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 inicial.

[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 contenido 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 se inicie en cualquier lugar.

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