WinAPI на русском

Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".

Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.

Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php

Обновления на сайте

В раздел Примеры кода добавился пример "Перемещение формы мышью не за заголовок".

Перевод

Сегодня вашему вниманию представлен перевод структуры OVERLAPPED.

OVERLAPPED

Структура OVERLAPPED содержит информацию, используемую в асинхронном вводе/выводе
(I/O).

typedef struct _OVERLAPPED
    DWORD Internal;
    DWORD InternalHigh;
    DWORD Offset;
    DWORD OffsetHigh;
    HANDLE hEvent;
} OVERLAPPED;
 
Члены

Internal – зарезервирован для использования операционной системой. Этот член,
который определяет системно-зависимый статус, имеет смысл, когда функция GetOverlappedResult
завершается без установки расширенной информации об ошибке в ERROR_IO_PENDING.
InternalHigh – зарезервирован для использования операционной системой. Этот член,
значение которого определяет длину переданных данных, имеет смысл, когда функция
GetOverlappedResult возвращает TRUE.
Offset – определяет позицию в файле, с которой надо начинать передачу. Позиция
в файле – смещение в байтах от начала файла. Вызывающий процесс устанавливает
значение этого члена перед вызовом функций ReadFile или WriteFile. Значение члена
игнорируется, при чтении из или записи в именованные каналы и устройства связи.
OffsetHigh – определяет старшее слово смещения, с которого надо начинать передачу.
Значение члена игнорируется, при чтении из или записи в именованные каналы и
устройства связи.
hEvent – идентифицирует событие, устанавливаемое в сигнальное состояние при завершении
передачи. Вызывающий процесс устанавливает значение этого члена перед вызовом
функций ReadFile, WriteFile, ConnectNamedPipe или TransactNamedPipe function.

Комментарии

Вы можете использовать макрос HasOverlappedIoCompleted чтобы определить, завершилась
ли асинхронная операция ввода/вывода. Вы можете использовать функцию CancelIo
для прерывания асинхронной операции ввода/вывода.

См. также

CancelIo, ConnectNamedPipe, CreateFile, GetOverlappedResult, HasOverlappedIoCompleted,
ReadFile, ReadFileEx, TransactNamedPipe, WriteFile, WriteFileEx.


Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn

С уважением, 
ведущий рассылки
Тарас Сорока.
mailto:stathome@rol.ru