IHostIoCompletionManager::GetHostOverlappedSize, metod
Hämtar storleken på anpassade data som värden avser att lägga till i I/O-begäranden.
Syntax
HRESULT GetHostOverlappedSize (
[out] DWORD *pcbSize
);
Parametrar
pcbSize
[ut] En pekare till antalet byte som CLR (Common Language Runtime) ska allokera utöver storleken på Win32-objektet OVERLAPPED
.
Returvärde
HRESULT | Description |
---|---|
S_OK | GetHostOverlappedSize returnerades. |
HOST_E_CLRNOTAVAILABLE | CLR har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet. |
HOST_E_TIMEOUT | Tidsgränsen för samtalet överst. |
HOST_E_NOT_OWNER | Anroparen äger inte låset. |
HOST_E_ABANDONED | En händelse avbröts medan en blockerad tråd eller fiber väntade på den. |
E_FAIL | Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE. |
Kommentarer
Alla asynkrona I/O-anrop till Windows Platform-API:er tar ett Win32-objekt OVERLAPPED
som innehåller information som filpekarens position. För att upprätthålla tillståndet lägger program som gör asynkrona I/O-anrop vanligtvis till anpassade data i strukturen. GetHostOverlappedSize
och IHostIoCompletionManager::InitializeHostOverlapped ger värden möjlighet att inkludera sådana anpassade data.
CLR anropar GetHostOverlappedSize
metoden för att fastställa storleken på de anpassade data som värden avser att lägga till i OVERLAPPED
objektet.
Anteckning
GetHostOverlappedSize
anropas bara en gång. Värdens anpassade data måste ha samma storlek för varje I/O-begäran.
Viktigt
Storleken på OVERLAPPED
själva objektet ingår inte i värdet pcbSize
för .
Mer information om strukturen finns i OVERLAPPED
Dokumentation om Windows-plattformen.
Krav
Plattformar: Se Systemkrav.
Huvudet: MSCorEE.h
Bibliotek: Ingår som en resurs i MSCorEE.dll
.NET Framework versioner: Tillgänglig sedan 2.0