Метод IHostIoCompletionManager::GetHostOverlappedSize
Возвращает размер любых пользовательских данных, которые узел намерен добавить к запросам ввода-вывода.
Синтаксис
HRESULT GetHostOverlappedSize (
[out] DWORD *pcbSize
);
Параметры
pcbSize
[out] Указатель на количество байтов, которое должна выделить среда CLR в дополнение к размеру объекта Win32 OVERLAPPED .
Возвращаемое значение
| HRESULT | Описание: |
|---|---|
| S_OK | GetHostOverlappedSize возвращается успешно. |
| HOST_E_CLRNOTAVAILABLE | Среда CLR не была загружена в процесс или среда CLR находится в состоянии, в котором она не может выполнить управляемый код или обработать вызов. |
| HOST_E_TIMEOUT | Истекло время ожидания звонка. |
| HOST_E_NOT_OWNER | Вызывающий объект не является владельцем блокировки. |
| HOST_E_ABANDONED | Событие было отменено во время ожидания заблокированного потока или волокна. |
| E_FAIL | Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не поддерживается в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE. |
Комментарии
Все асинхронные вызовы ввода-вывода к API платформы Windows принимают объект Win32 OVERLAPPED , который предоставляет такие сведения, как положение указателя файла. Для поддержания состояния приложения, которые выполняют асинхронные вызовы ввода-вывода, обычно добавляют пользовательские данные в структуру. GetHostOverlappedSize и IHostIoCompletionManager::InitializeHostOverlapped предоставляют узлу возможность включать такие пользовательские данные.
Среда CLR вызывает метод , GetHostOverlappedSize чтобы определить размер пользовательских данных, которые узел намерен добавить к объекту OVERLAPPED .
Примечание
GetHostOverlappedSize вызывается только один раз. Пользовательские данные узла должны иметь одинаковый размер для каждого запроса ввода-вывода.
Важно!
Размер OVERLAPPED самого объекта не включается в значение pcbSize.
Дополнительные сведения о структуре см. в OVERLAPPED документации по платформе Windows.
Требования
Платформы: см. раздел Требования к системе.
Заголовка: MSCorEE.h
Библиотека: Включено в качестве ресурса в MSCorEE.dll
версии платформа .NET Framework: доступно с версии 2.0
