IDebugDisassemblyStream2::Seek

  • Artikel

Verschiebt den Lesezeiger im Demontagedatenstrom um eine bestimmte Anzahl von Anweisungen relativ zu einer angegebenen Position.

Syntax

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

Parameter

dwSeekStart
[in] Ein Wert aus der SEEK_START-Aufzählung , die die relative Position angibt, um den Suchvorgang zu beginnen.

pCodeContext
[in] Das IDebugCodeContext2 -Objekt, das den Codekontext darstellt, zu dem der Suchvorgang relativ ist. Dieser Parameter wird nur verwendet, wenn dwSeekStart = SEEK_START_CODECONTEXT; andernfalls wird dieser Parameter ignoriert und kann ein NULL-Wert sein.

uCodeLocationId
[in] Der Codespeicherortbezeichner, zu dem der Suchvorgang relativ ist. Dieser Parameter wird verwendet, wenn dwSeekStart = SEEK_START_CODELOCID; andernfalls wird dieser Parameter ignoriert und kann auf 0 festgelegt werden. Eine Beschreibung eines Codespeicherortbezeichners finden Sie im Abschnitt "Hinweise" für die GetCodeLocationId-Methode .

iInstructions
[in] Die Anzahl der Anweisungen, die relativ zur angegebenen Position verschoben dwSeekStartwerden sollen. Dieser Wert kann negativ sein, um rückwärts zu wechseln.

Rückgabewert

Gibt bei Erfolg S_OK zurück. Gibt zurück S_FALSE , wenn die Suchposition auf einen Punkt über die Liste der verfügbaren Anweisungen hinaus war. Andernfalls wird ein Fehlercode zurückgegeben.

Hinweise

Wenn die Suche vor dem Anfang der Liste eine Position war, wird die Leseposition auf die erste Anweisung in der Liste festgelegt. Wenn die Position nach dem Ende der Liste auf eine Position festgelegt wurde, wird die Leseposition auf die letzte Anweisung in der Liste festgelegt.

Siehe auch