IWorkerThreadClient-Schnittstelle

IWorkerThreadClient ist die Schnittstelle, die von Clients der CWorkerThread-Klasse implementiert wird.

Wichtig

Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Syntax

__interface IWorkerThreadClient

Mitglieder

Methoden

Name	Beschreibung
Closehandle	Implementieren Sie diese Methode, um das diesem Objekt zugeordnete Handle zu schließen.
Ausführen	Implementieren Sie diese Methode, um Code auszuführen, wenn das diesem Objekt zugeordnete Handle signalisiert wird.

Hinweise

Implementieren Sie diese Schnittstelle, wenn Sie Code haben, der in einem Arbeitsthread ausgeführt werden muss, um darauf zu reagieren, dass ein Handle signalisiert wird.

Anforderungen

Header: atlutil.h

IWorkerThreadClient::CloseHandle

Implementieren Sie diese Methode, um das diesem Objekt zugeordnete Handle zu schließen.

HRESULT CloseHandle(HANDLE  hHandle);

Parameter

hHandle
Der zu schließende Ziehpunkt.

Rückgabewert

Gibt S_OK bei Erfolg zurück oder ein HRESULT-Fehler beim Fehler.

Hinweise

Das an diese Methode übergebene Handle wurde zuvor durch einen Aufruf von CWorkerThread::AddHandle diesem Objekt zugeordnet.

Beispiel

Der folgende Code zeigt eine einfache Implementierung von IWorkerThreadClient::CloseHandle.

HRESULT CloseHandle(HANDLE hObject)
{
   // Users should do any shutdown operation required here.
   // Generally, this means just closing the handle.

   if (!::CloseHandle(hObject))
   {
      // Closing the handle failed for some reason.
      return AtlHresultFromLastError();
   }

   return S_OK;
}

IWorkerThreadClient::Execute

Implementieren Sie diese Methode, um Code auszuführen, wenn das diesem Objekt zugeordnete Handle signalisiert wird.

HRESULT Execute(DWORD_PTR dwParam, HANDLE hObject);

Parameter

dwParam
Der Benutzerparameter.

hObject
Der Ziehpunkt, der signalisiert wurde.

Rückgabewert

Gibt S_OK bei Erfolg zurück oder ein HRESULT-Fehler beim Fehler.

Hinweise

Der an diese Methode übergebene Handle und DWORD/Zeiger wurden zuvor durch einen Aufruf von CWorkerThread::AddHandle diesem Objekt zugeordnet.

Beispiel

Der folgende Code zeigt eine einfache Implementierung von IWorkerThreadClient::Execute.

HRESULT Execute(DWORD_PTR dwParam, HANDLE hObject)
{
   // Cast the parameter to its known type.
   LONG* pn = reinterpret_cast<LONG*>(dwParam);

   // Increment the LONG.
   LONG n = InterlockedIncrement(pn);

   // Log the results.
   printf_s("Handle 0x%08X incremented value to : %d\n", (DWORD_PTR)hObject, n);

   return S_OK;
}

Siehe auch

Klassen
CWorkerThread-Klasse