Skip to content

Latest commit

 

History

History
99 lines (61 loc) · 2.72 KB

iworkerthreadclient-interface.md

File metadata and controls

99 lines (61 loc) · 2.72 KB
description title ms.date f1_keywords helpviewer_keywords ms.assetid
Learn more about: IWorkerThreadClient Interface
IWorkerThreadClient Interface
11/04/2016
IWorkerThreadClient
ATLUTIL/ATL::IWorkerThreadClient
ATLUTIL/ATL::CloseHandle
ATLUTIL/ATL::Execute
IWorkerThreadClient interface
56f4a2f5-007e-4a33-9e20-05187629f715

IWorkerThreadClient Interface

IWorkerThreadClient is the interface implemented by clients of the CWorkerThread class.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

Syntax

__interface IWorkerThreadClient

Members

Methods

Name Description
CloseHandle Implement this method to close the handle associated with this object.
Execute Implement this method to execute code when the handle associated with this object becomes signaled.

Remarks

Implement this interface when you have code that needs to execute on a worker thread in response to a handle becoming signaled.

Requirements

Header: atlutil.h

IWorkerThreadClient::CloseHandle

Implement this method to close the handle associated with this object.

HRESULT CloseHandle(HANDLE  hHandle);

Parameters

hHandle
The handle to be closed.

Return Value

Return S_OK on success, or an error HRESULT on failure.

Remarks

The handle passed to this method was previously associated with this object by a call to CWorkerThread::AddHandle.

Example

The following code shows a simple implementation of IWorkerThreadClient::CloseHandle.

[!code-cppNVC_ATL_Utilities#135]

IWorkerThreadClient::Execute

Implement this method to execute code when the handle associated with this object becomes signaled.

HRESULT Execute(DWORD_PTR dwParam, HANDLE hObject);

Parameters

dwParam
The user parameter.

hObject
The handle that has become signaled.

Return Value

Return S_OK on success, or an error HRESULT on failure.

Remarks

The handle and DWORD/pointer passed to this method were previously associated with this object by a call to CWorkerThread::AddHandle.

Example

The following code shows a simple implementation of IWorkerThreadClient::Execute.

[!code-cppNVC_ATL_Utilities#136]

See also

Classes
CWorkerThread Class