IOleComponent2.OnHandleSignaled Method

When overridden in a derived class, enables the component to respond to a signal on a wait handle.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop.9.0 (in Microsoft.VisualStudio.Shell.Interop.9.0.dll)


Function OnHandleSignaled ( _
    nHandle As UInteger, _
    pvLoopData As IntPtr, _
    <OutAttribute> ByRef pfContinue As Boolean _
) As Integer
‘사용 방법
Dim instance As IOleComponent2
Dim nHandle As UInteger
Dim pvLoopData As IntPtr
Dim pfContinue As Boolean
Dim returnValue As Integer

returnValue = instance.OnHandleSignaled(nHandle, _
    pvLoopData, pfContinue)
int OnHandleSignaled(
    uint nHandle,
    IntPtr pvLoopData,
    out bool pfContinue
int OnHandleSignaled(
    [InAttribute] unsigned int nHandle, 
    [InAttribute] IntPtr pvLoopData, 
    [OutAttribute] bool% pfContinue
abstract OnHandleSignaled : 
        nHandle:uint32 * 
        pvLoopData:IntPtr * 
        pfContinue:bool byref -> int 
function OnHandleSignaled(
    nHandle : uint, 
    pvLoopData : IntPtr, 
    pfContinue : boolean
) : int


  • nHandle
    Type: System.UInt32
    The zero-based index of the handle that was signaled.
  • pfContinue
    Type: System.Boolean%
    When this method returns, contains true to have this component re-enter the message loop, or false to exit the message loop immediately.

Return Value

Type: System.Int32
An error code (HRESULT) value that indicates the status of the operation.


nHandle contains the index of the wait handle in the array that was returned when the component manager called GetWaitHandlesAndTimeout.

If pfContinue is true, the component manager calls GetWaitHandlesAndTimeout to update the wait handles and time-out for this component, and then resumes the message loop.

This method is called on the same thread as the FPushMessageLoop method was called on when this component was added to the message loop.

.NET Framework Security

See Also


IOleComponent2 Interface

IOleComponent2 Members

Microsoft.VisualStudio.Shell.Interop Namespace