ICorDebugManagedCallback3::CustomNotification Method

  • Article

Indicates that a custom debugger notification has been raised.

Syntax

HRESULT CustomNotification(ICorDebugThread *    pThread,
                           ICorDebugAppDomain * pAppDomain);

Parameters

pThread [in] A pointer to the thread that raised the notification.

pAppDomain [in] A pointer to the application domain that contains the thread that raised the notification.

Return Value

This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULT Description
S_OK The method completed successfully.

Exceptions

Remarks

A subsequent call to the ICorDebugThread4::GetCurrentCustomDebuggerNotification method retrieves the thread object that was passed to the Debugger.NotifyOfCrossThreadDependency method. The thread object's type must have been previously enabled by calling the ICorDebugProcess3::SetEnableCustomNotification method. The debugger can read type-specific parameters from the fields of the thread object, and can store responses into fields.

The ICorDebug interface imposes no policy on the types of notifications or their contents, and the semantics of the notifications are strictly a contract between debuggers, applications, and the .NET Framework.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

See also