IHostThreadPoolManager::GetMaxThreads-Methode

Artikel
08/10/2011

Ruft die maximale Anzahl von Threads ab, die der Host gleichzeitig im Threadpool verwaltet.

HRESULT GetMaxThreads (
    [out] DWORD *pdwMaxWorkerThreads
);

Parameter

pdwMaxWorkerThreads
[out] Ein Zeiger auf die maximale Anzahl von Threads, die der Host im Threadpool verwaltet.

Rückgabewert

HRESULT	Beschreibungen
S_OK	GetMaxThreads erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_NOTIMPL	Der Host stellt keine Implementierung von GetMaxThreads bereit.

Hinweise

Die CLR ruft GetMaxThreads auf, um die Gesamtzahl von Threads im Threadpool zu bestimmen. Die GetAvailableThreads-Methode ruft die Anzahl von Threads ab, die zurzeit keine Arbeitsaufgaben verarbeiten. Alle über dem zurückgegeben Wert des pdwMaxWorkerThreads-Parameters liegenden Anforderungen bleiben in der Warteschlange, bis die Threads verfügbar sind.

Wenn der Host keine Implementierung von GetMaxThreads bereitstellt, muss er den HRESULT-Wert E_NOTIMPL zurückgeben.