Dela via


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 pcbSizefö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

Se även