Interface ICorDebugVariableHomeICorDebugVariableHome Interface

Representa uma variável local ou um argumento de uma função.Represents a local variable or argument of a function.

MétodosMethods

MétodoMethod DescriçãoDescription
Método GetArgumentIndexGetArgumentIndex Method Obtém o índice de um argumento de função.Gets the index of a function argument.
Método GetCodeGetCode Method Obtém a instância "ICorDebugCode" que contém este ICorDebugVariableHome objeto.Gets the "ICorDebugCode" instance that contains this ICorDebugVariableHome object.
Método GetLiveRangeGetLiveRange Method Obtém o intervalo nativo no qual essa variável está ativa.Gets the native range over which this variable is live.
Método GetLocationTypeGetLocationType Method Obtém o tipo do local nativo da variável.Gets the type of the variable's native location.
Método GetOffsetGetOffset Method Obtém o deslocamento do registro base de uma variável.Gets the offset from the base register for a variable.
Método GetRegisterGetRegister Method Obtém o registro que contém uma variável com um tipo de local de VLT_REGISTER e o registro base para uma variável com um tipo de local de VLT_REGISTER_RELATIVE .Gets the register that contains a variable with a location type of VLT_REGISTER, and the base register for a variable with a location type of VLT_REGISTER_RELATIVE.
Método GetSlotIndexGetSlotIndex Method Obtém o índice de slot gerenciado de uma variável local.Gets the managed slot-index of a local variable.

ExemploExample

O fragmento de código a seguir usa o objeto ICorDebugCode4 chamado pCode4 .The following code fragment uses the ICorDebugCode4 object named pCode4.

ICorDebugCode4 *pCode4 = NULL;  
pCode->QueryInterface(IID_ICorDebugCode4, &pCode4);  
  
ICorDebugVariableEnum *pVarLocEnum = NULL;  
pCode4->EnumerateVariableHomes(&pVarLocEnum);  
  
// retrieve local variables and arguments  
ULONG celt = 0;  
pVarLocEnum->GetCount(&celt);  
ICorDebugVariableHome **homes = new ICorDebugVariableHome *[celt];  
ULONG celtFetched = 0;  
pVarLocEnum->Next(celt, homes, &celtFetched);  
  
for (int i = 0; i < celtFetched; i++)  
{  
    VariableLocationType locType = VLT_INVALID;  
    homes[i].GetLocationType(&locType);  
    switch (locType)  
    {  
    case VLT_REGISTER:  
        CorDebugRegister register = 0;  
        locals[i].GetRegister(&register);  
        // now we know which register it is in  
        break;  
    case VLT_REGISTER_RELATIVE:  
        CorDebugRegister baseRegister = 0;  
        LONG offset = 0;  
        locals[i].GetRegister(&register);  
        locals[i].GetOffset(&offset);  
        // now we know the register-relative offset  
        break;  
    case VLT_INVALID:  
        // handle case where we can't access the location  
        break;  
    }  
}  

RequisitosRequirements

Plataformas: confira Requisitos do sistema.Platforms: See System Requirements.

Cabeçalho: CorDebug.idl, CorDebug.hHeader: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.libLibrary: CorGuids.lib

.NET Framework versões:Disponível desde o 4.6.2Available since 4.6.2.NET Framework Versions: Disponível desde o 4.6.2Available since 4.6.2

Consulte tambémSee also