Metodo IDebugDataSpaces4::SearchVirtual2 (dbgeng.h)

Articolo
08/07/2023

Il metodo SearchVirtual2 cerca la memoria virtuale del processo per un modello specificato di byte.

Sintassi

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

Parametri

[in] Offset

Specifica il percorso nello spazio indirizzi virtuale del processo per iniziare a cercare il modello.

[in] Length

Specifica la distanza da cercare per il modello. Una corrispondenza con esito positivo richiede che l'intero modello venga trovato prima dell'esame dei byte di lunghezza .

[in] Flags

Specifica un campo bit di flag per la ricerca. Attualmente, l'unico flag bit che può essere impostato è DEBUG_VSEARCH_WRITABLE_ONLY, che limita la ricerca alla memoria scrivibile.

[in] Pattern

Specifica il modello da cercare.

[in] PatternSize

Specifica le dimensioni, in byte, del modello. Questo deve essere un multiplo della granularità del modello.

[in] PatternGranularity

Specifica la granularità del modello. Per una corrispondenza riuscita, la differenza tra la posizione del modello trovato e Offset deve essere un multiplo di PatternGranularity.

[out] MatchOffset

Riceve la posizione nello spazio indirizzi virtuale del processo del modello, se è stato trovato.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Dopo aver esaminato i byte di lunghezza , il modello non è stato trovato.

Commenti

Questo metodo cerca la memoria virtuale della destinazione per la prima occorrenza, soggetta a granularità, del modello interamente contenuto nei byte di lunghezza della memoria della destinazione, a partire dalla posizione offset.

PatternGranularity può essere usato per garantire l'allineamento della corrispondenza rispetto a Offset. Ad esempio, un valore di 0x4 può essere usato per richiedere l'allineamento a una DWORD. Un valore di 0x1 può essere usato per consentire all'avvio del modello ovunque.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (includere Dbgeng.h)

Vedi anche

IDebugDataSpaces4

SearchVirtual

Condividi tramite