IObjectWithCancelEvent::GetCancelEvent method (shobjidl_core.h)

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

Syntax

HRESULT GetCancelEvent(
  [out] HANDLE *phEvent
);

Parameters

[out] phEvent

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

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

IObjectWithCancelEvent