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

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

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

  • Last updated on