Асинхронный файловый ввод/вывод в операционной системе WINDOWS, страница 3

Аргумент

Описание

IpFileName

Указатель на имя файла или устройства

DesiredAccess

Устанавливает вид доступа к объекту. Приложение может создать (открыть) файл (устройство) для чтения, записи, чтения/записи или • в режиме запроса к устройству. Значение 0 (ноль) указывает на то, что программа желает проверить возможность доступа к объекту. В противном случае можно использовать GENERIC.READ (чтение), GENERICWRITE (запись) или и то и другое (оба значения объединяются при помощи оператора | — логическое сложение)

dwShareMode

Набор битовых флагов, указывающий на режим совместного доступа к объекту. Если значение dwShareMode равно 0, совместный доступ к объекту запрещен. Все последующие операции, направленные на открытие объекта, не сработают до тех пор, пока ваша программа не закроет дескриптор. Если необходимо обеспечить совместный доступ к файлу, используйте комбинацию флагов FILESHAREDELETE (совместное удаление), FILE SHARE READ (совместное чтение) и FILESHAREWRITE (совместная запись)

IpSecurityAttributes

Указатель на структуру SECURITY.ATTRIBUTES, которая определяет, будет ли создаваемый дескриптор наследоваться дочерними процессами. Если аргумент IpSecurityAttributes имеет значение NULL, дескриптор не будет наследоваться

dwCreationDisposition

Указывает, каким образом следует создать (или открыть) файл. Допускается использовать следующие значения: CREATENEW (создать новый файл; если файл существует, функция не срабатывает), CREATEALWAYS (создать новый файл; если файл существует, он перезаписывается), OPENEXISTING (открыть файл; если файл не существует, функция не срабатывает), OPENALWAYS (открыть файл; если файл не существует, он создается) или TRUNCATEEXISTING (открыть файл и сделать его длину равной нулю; если файл не существует, функция не срабатывает)

dwFlagsAndAttributes

Набор атрибутов и флагов, которыми должен обладать файл. Например, если требуется, чтобы новый файл был скрытым, используйте значение FILEATTRIBUTEHIDDEN; если при работе с файлом требуется отключить кэширование, используйте значение FILEFLAGNOBUFFERING. Возможные значения флагов перечислены в табл.2. Здесь же можно использовать специальные флаги для именованных каналов

hTemplateFile

Содержит дескриптор с доступом GENERICREAD. Это дескриптор шаблонного файла, атрибуты которого (включая расширенные) будут присвоены создаваемому файлу