This documentation is archived and is not being maintained.

ICorProfilerCallback::Initialize Method

Called to initialize the code profiler whenever a new common language runtime (CLR) application is started.

HRESULT Initialize(
    [in] IUnknown     *pICorProfilerInfoUnk);

pICorProfilerInfoUnk

[in] Pointer to an IUnknown interface that the profiler must query for an ICorProfilerInfo interface pointer.

The Initialize call is the only opportunity to enable (or disable) callbacks that are immutable. Once a callback is enabled by the Initialize call, it cannot be disabled later using ICorProfilerInfo::SetEventMask. The COR_PRF_MONITOR_IMMUTABLE value of the COR_PRF_MONITOR enumeration indicates which events are immutable.

Platforms: See .NET Framework System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Show: