Share via

IDebugDisassemblyStream2::Seek

  • Artigo

Move o ponteiro de leitura no fluxo de desmontagem um determinado número de instruções em relação a uma posição especificada.

Sintaxe

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

Parâmetros

dwSeekStart
[em] Um valor da enumeração SEEK_START que especifica a posição relativa para iniciar o processo de busca.

pCodeContext
[em] O objeto IDebugCodeContext2 que representa o contexto de código ao qual a operação de busca é relativa. Esse parâmetro será usado somente se dwSeekStart = SEEK_START_CODECONTEXT; caso contrário, esse parâmetro será ignorado e poderá ser um valor nulo.

uCodeLocationId
[em] O identificador de local de código ao qual a operação de busca é relativa. Esse parâmetro será usado se dwSeekStart = SEEK_START_CODELOCID; caso contrário, esse parâmetro será ignorado e poderá ser definido como 0. Consulte a seção Comentários para o método GetCodeLocationId para obter uma descrição de um identificador de local de código.

iInstructions
[em] O número de instruções a serem movidas em relação à posição especificada em dwSeekStart. Esse valor pode ser negativo para retroceder.

Valor de retorno

Se for bem-sucedido, retornará S_OK. Retorna S_FALSE se a posição de busca foi para um ponto além da lista de instruções disponíveis. Caso contrário, retornará um código de erro.

Comentários

Se a busca foi para uma posição antes do início da lista, a posição de leitura é definida como a primeira instrução na lista. Se a posição ver foi para uma posição após o final da lista, a posição de leitura é definida como a última instrução na lista.

Confira também