ICorDebugProcess3::SetEnableCustomNotification Method

  • Article

Enables and disables custom debugger notifications of the specified type.

Syntax

HRESULT SetEnableCustomNotification(ICorDebugClass * pClass,
                                    BOOL fEnable);

Parameters

pClass [in] The type that specifies custom debugger notifications.

fEnable [in] true to enable custom debugger notifications; false to disable notifications. The default value is false.

Remarks

When fEnable is set to true, calls to the Debugger.NotifyOfCrossThreadDependency method trigger an ICorDebugManagedCallback3::CustomNotification callback. Notifications are disabled by default; therefore, the debugger must specify any notification types it knows about and wants to handle. Because the ICorDebugClass class is scoped by application domain, the debugger must call SetEnableCustomNotification for every application domain in the process if it wants to receive the notification across the entire process.

Starting with the .NET Framework 4, the only supported notification is a cross-thread dependency notification.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

See also