ICorDebugFunction Interface
Represents a managed function or method.
interface ICorDebugFunction : IUnknown {
HRESULT CreateBreakpoint (
[out] ICorDebugFunctionBreakpoint **ppBreakpoint
);
HRESULT GetClass (
[out] ICorDebugClass **ppClass
);
HRESULT GetCurrentVersionNumber (
[out] ULONG32 *pnCurrentVersion
);
HRESULT GetILCode (
[out] ICorDebugCode **ppCode
);
HRESULT GetLocalVarSigToken (
[out] mdSignature *pmdSig
);
HRESULT GetModule (
[out] ICorDebugModule **ppModule
);
HRESULT GetNativeCode (
[out] ICorDebugCode **ppCode
);
HRESULT GetToken (
[out] mdMethodDef *pMethodDef
);
};
Methods
Method |
Description |
|---|---|
Creates a breakpoint at the beginning of this function. |
|
Gets an ICorDebugClass object that represents the class this function is a member of. |
|
Gets the version number of the latest edit made to this function. |
|
Gets the Microsoft intermediate language (MSIL) code for this function. |
|
Gets the metadata token for the local variable signature of the function that is represented by this ICorDebugFunction instance. |
|
Gets the module in which this function is defined. |
|
Gets the native code for this function. |
|
Gets the metadata token for this function. |
Remarks
The ICorDebugFunction interface does not represent a function with generic type parameters. For example, an ICorDebugFunction instance would represent Func<T> but not Func<string>. Call ICorDebugILFrame2::EnumerateTypeParameters to get the generic type parameters.
The relationship between a method's metadata token, mdMethodDef, and a method's ICorDebugFunction object is dependent upon whether Edit and Continue is allowed on the function:
If Edit and Continue is not allowed on the function, a one-to-one relationship exists between the ICorDebugFunction object and the mdMethodDef token. That is, the function has one ICorDebugFunction object and one mdMethodDef token.
If Edit and Continue is allowed on the function, a many-to-one relationship exists between the ICorDebugFunction object and the mdMethodDef token. That is, the function may have many instances of ICorDebugFunction, one for each version of the function, but only one mdMethodDef token.
Requirements
Platform: Windows 2000, Window XP, Windows Server 2003 family
Header: CorDebug.idl
Library: CorGuids.lib
.NET Framework Version: 2.0, 1.1, 1.0