IHostTaskManager::CreateTask-Methode

Artikel
06/05/2023

Fordert an, dass der Host eine neue Aufgabe erstellt

Syntax

HRESULT CreateTask (  
    [in]  DWORD stacksize,
    [in]  LPTHREAD_START_ROUTINE pStartAddress,  
    [in]  PVOID pParameter,  
    [out] IHostTask **ppTask  
);

Parameter

stacksize
[in] Die angeforderte Größe des angeforderten Stapels in Bytes oder 0 (null) für die Standardgröße

pStartAddress
[in] Ein Zeiger auf die Funktion, die von der Aufgabe ausgeführt werden soll

pParameter
[in] Ein Zeiger auf die Benutzerdaten, die an die Funktion übergeben werden sollen, oder NULL, wenn die Funktion keine Parameter akzeptiert

ppTask
[out] Ein Zeiger auf die Adresse einer IHostTask-Instanz vom Host erstellt, oder NULL, wenn die Aufgabe nicht erstellt werden kann. Die Aufgabe bleibt in einem angehaltenen Zustand, bis sie explizit durch einen Aufruf von IHostTask::Start gestartet wird.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`CreateTask` wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Timeout des Aufrufs.
HOST_E_NOT_OWNER	Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL	Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_OUTOFMEMORY	Zum Erstellen des angeforderten Ereignisobjekts war nicht genügend Arbeitsspeicher verfügbar.

Bemerkungen

Die CLR ruft CreateTask auf, um die Erstellung einer neuen Aufgabe durch den Host anzufordern. Der Host gibt einen Schnittstellenzeiger an eine IHostTask-Instanz zurück. Die zurückgegebene Aufgabe muss solange angehalten bleiben, bis sie explizit durch einen Aufruf IHostTask::Startvon gestartet wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Freigeben über