ThreadPoolBoundHandle
E697535
ThreadPoolBoundHandle is a .NET threading type that represents a handle bound to the thread pool, enabling efficient asynchronous I/O operations using overlapped I/O.
Statements (43)
| Predicate | Object |
|---|---|
| instanceOf |
.NET type
ⓘ
System.Threading type ⓘ class ⓘ |
| definedInAssembly | System.Threading.Overlapped.dll NERFINISHED ⓘ |
| designGoal |
provide safe wrapper over native overlapped structures
ⓘ
reduce overhead of binding OS handles to the thread pool ⓘ |
| documentationUrl | https://learn.microsoft.com/dotnet/api/system.threading.threadpoolboundhandle ⓘ |
| errorCondition |
throws ArgumentException when handle is invalid or not overlapped-capable
ⓘ
throws ArgumentNullException when handle is null in BindHandle ⓘ |
| hasMethod |
AllocateNativeOverlapped(IOCompletionCallback callback, object state, byte[] pinData)
ⓘ
AllocateNativeOverlapped(PreAllocatedOverlapped preAllocated) ⓘ BindHandle(IntPtr handle) ⓘ BindHandle(SafeHandle handle) ⓘ Dispose() ⓘ FreeNativeOverlapped(NativeOverlapped* overlapped) ⓘ |
| hasProperty | Handle ⓘ |
| implements | System.IDisposable NERFINISHED ⓘ |
| introducedIn |
.NET Core 1.0
NERFINISHED
ⓘ
.NET Framework 4 NERFINISHED ⓘ |
| isDisposable | true ⓘ |
| isPublic | true ⓘ |
| isSealed | true ⓘ |
| lifecycle | must be disposed to release bound handle resources ⓘ |
| namespace | System.Threading NERFINISHED ⓘ |
| platform | Windows-focused overlapped I/O ⓘ |
| propertyType | Handle: System.Runtime.InteropServices.SafeHandle ⓘ |
| purpose |
enables efficient asynchronous I/O operations
ⓘ
represents a handle bound to the thread pool ⓘ |
| relatedTo |
I/O completion ports
ⓘ
NativeOverlapped NERFINISHED ⓘ Overlapped ⓘ ThreadPool NERFINISHED ⓘ |
| requires |
handle must be opened for overlapped I/O
ⓘ
handle must be suitable for I/O completion ports ⓘ |
| security | demands appropriate permissions to access underlying handle ⓘ |
| supports | overlapped I/O ⓘ |
| threadSafety |
instance members are not guaranteed to be thread-safe
ⓘ
members are thread-safe for static operations ⓘ |
| usagePattern |
created by binding an existing OS handle to the thread pool
ⓘ
used with overlapped I/O callbacks ⓘ |
| usedFor |
file I/O completion callbacks
ⓘ
named pipe asynchronous operations ⓘ socket I/O completion callbacks ⓘ |
Referenced by (1)
Full triples — surface form annotated when it differs from this entity's canonical label.