Condividi tramite

IDebugDisassemblyStream2::Seek

  • Articolo

Sposta il puntatore di lettura nel flusso disassembly di un determinato numero di istruzioni rispetto a una posizione specificata.

Sintassi

int Seek( 
   enum_SEEK_START    dwSeekStart,
   IDebugCodeContext2 pCodeContext,
   ulong              uCodeLocationId,
   long               iInstructions
);

Parametri

dwSeekStart
[in] Valore dell'enumerazione edizione StandardEK_START che specifica la posizione relativa per avviare il processo di ricerca.

pCodeContext
[in] Oggetto IDebugCodeContext2 che rappresenta il contesto di codice a cui l'operazione di ricerca è relativa. Questo parametro viene usato solo se dwSeekStart = SEEK_START_CODECONTEXT; in caso contrario, questo parametro viene ignorato e può essere un valore Null.

uCodeLocationId
[in] Identificatore del percorso del codice a cui l'operazione di ricerca è relativa. Questo parametro viene utilizzato se dwSeekStart = SEEK_START_CODELOCID; in caso contrario, questo parametro viene ignorato e può essere impostato su 0. Per una descrizione di un identificatore di percorso del codice, vedere la sezione Osservazioni per il metodo GetCodeLocationId .

iInstructions
[in] Numero di istruzioni da spostare in relazione alla posizione specificata in dwSeekStart. Questo valore può essere negativo per spostarsi all'indietro.

Valore restituito

Se l'esito è positivo, restituisce S_OK. Restituisce S_FALSE se la posizione di ricerca era a un punto oltre l'elenco delle istruzioni disponibili. In caso contrario, verrà restituito un codice di errore.

Osservazioni:

Se la ricerca si trovava in una posizione prima dell'inizio dell'elenco, la posizione di lettura viene impostata sulla prima istruzione nell'elenco. Se la visualizzazione corrisponde a una posizione dopo la fine dell'elenco, la posizione di lettura viene impostata sull'ultima istruzione nell'elenco.

Vedi anche