IHostIoCompletionManager::SetMaxThreads-Methode

Aktualisiert: November 2007

Legt die maximale Anzahl von Threads fest, die vom Host für E/A-Anforderungen reserviert werden.

HRESULT SetMaxThreads (
    [in] DWORD dwMaxIoCompletionThreads
);

Parameter

dwMaxIoCompletionThreads
[in] Die maximale Anzahl von Threads, die für E/A-Anforderungen reserviert 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 befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Das Zeitlimit für den Aufruf wurde ü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 SetMaxThreads bereit.

Hinweise

SetMaxThreads ermöglicht es der CLR, die maximale Anzahl von Threads festzulegen, die zum Bedienen von Anforderungen an E/A-Anschlüssen zur Verfügung stehen. Ein Host muss die Größe des Threadpools möglicherweise exklusiv steuern, z. B. für Implementierungen oder aus Leistungs- oder Skalierbarkeitsgründen. Aus diesem Grund ist es nicht erforderlich, dass der Host SetMaxThreads implementiert. In diesem Fall sollte ein Host E_NOTIMPL für diese Methode zurückgeben.