Freigeben über

IHostIoCompletionManager::SetMaxThreads-Methode

  • Artikel

Legt die maximale Anzahl von Threads fest, die der Host an E/A-Dienstanforderungen sendet.

Syntax

HRESULT SetMaxThreads (  
    [in] DWORD dwMaxIoCompletionThreads  
);

Parameter

dwMaxIoCompletionThreads
[in] Die maximale Anzahl von Threads, die für E/A-Anforderungen zugewiesen werden sollen.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK SetMaxThreads 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_NOTIMPL Der Host stellt keine Implementierung von SetMaxThreads bereit.

Bemerkungen

SetMaxThreads bietet der CLR die Möglichkeit, die maximale Anzahl von Threads festzulegen, die für Dienstanforderungen an E/A-Ports verfügbar sind. Ein Host benötigt möglicherweise die ausschließliche Kontrolle über die Größe des Threadpools, z. B. aus Gründen der Implementierung, der Leistung oder der Skalierbarkeit. Aus diesem Grund muss der Host SetMaxThreads nicht implementieren. In diesem Fall sollte der Host für diese Methode E_NOTIMPL zurückgeben.

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.

Siehe auch