IObjectWithCancelEvent::GetCancelEvent method

Retrieves an event that will be sent when an operation is canceled.

Syntax


HRESULT GetCancelEvent(
  [out] HANDLE *phEvent
);

Parameters

phEvent [out]

Type: HANDLE*

Pointer to a handle that, when this method successfully returns, is the handle to the cancel event. The caller is responsible for closing this handle when it is no longer needed.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Call this function to retrieve an event that will be signaled when the called object cancels the operation it is performing. The caller is responsible for closing the returned handle.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IObjectWithCancelEvent

 

 

Show: