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