Поделиться через

Метод 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

См. также раздел

  • Last updated on