Метод IHostIoCompletionManager::InitializeHostOverlapped

Статья
11/16/2008

Обновлен: Ноябрь 2007

Предоставляет основному приложению возможность инициализировать любые пользовательские данные для добавления в конец структуры OVERLAPPED, которая используется для асинхронных запросов ввода-вывода.

HRESULT InitializeHostOverlapped (
    [in] void* pvOverlapped
);

Параметры

pvOverlapped
[in] Указатель на структуру OVERLAPPED для Win32, которая должна быть включена при запросе ввода-вывода.

Возвращаемое значение

HRESULT	Описание
S_OK	Метод InitializeHostOverlapped успешно возвратил значение.
HOST_E_CLRNOTAVAILABLE	Среда 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 сообщает об ошибке и ей не удается выполнить вызов.