Compartilhar via


IDebugCodeContext2::GetDocumentContext

Obtém o contexto do documento que corresponde a esse contexto de código. O contexto do documento representa uma posição no arquivo de origem que corresponde ao código-fonte que gerou essa instrução.

Sintaxe

int GetDocumentContext( 
   out IDebugDocumentContext2 ppSrcCxt
);

Parâmetros

ppSrcCxt
[saiu] Retorna o objeto IDebugDocumentContext2 que corresponde ao contexto de código. Se S_OK for devolvido, este deve ser não-null.

Valor de retorno

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro. Um mecanismo de depuração deve retornar um código de falha, como E_FAIL quando o out parâmetro é null como quando o contexto do código não tem posição de origem associada.

Comentários

Geralmente, o contexto do documento pode ser considerado como uma posição em um arquivo de origem, enquanto o contexto de código é uma posição de uma instrução de código em um fluxo de execução.

Confira também