Основы программирования в Win32API. Марапулец Ю.В. - 59 стр.

UptoLike

Составители: 

Описание аргументов данной функции приведено в табл. 4.1.
Таблица 4.1
Аргумент Описание
lpFileName Указатель на имя файла или устройства
DesiredAccess
Устанавливает вид доступа к объекту. Приложение может
создать (открыть) файл (устройство) для чтения, записи, чте-
ния/записи или в режиме запроса к устройству. Значение 0
(ноль) указывает на то, что программа желает проверить воз-
можность доступа к объекту. В противном случае можно ис-
пользовать GENERIC_READ (чтение), GENERIC_WRITE (за-
пись) или и то и другое (оба значения объединяются при
помощи оператора | – логическое сложение)
dwShareMode
Набор битовых флагов, указывающий на режим совместного
доступа к объекту. Если значение dwShareMode равно 0, совмест-
ный доступ к объекту запрещен. Все последующие операции, на-
правленные на открытие объекта, не сработают до тех пор, пока
ваша программа не закроет дескриптор. Если необходимо обеспе-
чить совместный доступ к файлу, используйте комбинацию фла-
гов FILE_SHARE_DELETE (совместное удаление),
FILE_SHARE_READ (совместное чтение) и
FILE_SHARE_WRITE (совместная запись)
lpSecurityAttributes
Указатель на структуру SECURITY_ATTRIBUTES, которая
определяет, будет ли создаваемый дескриптор наследоваться
дочерними процессами. Если аргумент lpSecurityAttributes
имеет значение NULL, дескриптор не будет наследоваться
dwCreationDisposition
Указывает, каким образом следует создать (или открыть)
файл. Допускается использовать следующие значения:
CREATE_NEW (создать новый файл; если файл существует,
функция не срабатывает); CREATE_ALWAYS (создать новый
файл; если файл существует, он перезаписывается);
OPEN_EXISTING (открыть файл; если файл не существует,
функция не срабатывает); OPEN_ALWAYS (открыть файл; ес-
ли файл не существует, он создается) или TRUN-
CATE_EXISTING (открыть файл и сделать его длину равной
нулю; если файл не существует, функция не срабатывает)
dwFlagsAndAttributes
Набор атрибутов и флагов, которыми должен обладать файл.
Например, если требуется, чтобы новый файл был скрытым, ис-
пользуйте значение FILE_ATTRIBUTE_HIDDEN; если при работе
с файлом требуется отключить кэширование, используйте значе-
ние FILE_FLAG_NO_BUFFERING. Возможные значения флагов
перечислены в табл. 12.2. Здесь же можно использовать специаль-
ные флаги для именованных каналов
hTemplateFile
Содержит дескриптор с доступом GENERIC_READ. Это де-
скриптор шаблонного файла, атрибуты которого (включая
расширенные) будут присвоены создаваемому файлу
59
Описание аргументов данной функции приведено в табл. 4.1.

                                                                              Таблица 4.1

        Аргумент                                      Описание
       lpFileName                     Указатель на имя файла или устройства
                             Устанавливает вид доступа к объекту. Приложение может
                          создать (открыть) файл (устройство) для чтения, записи, чте-
                          ния/записи или в режиме запроса к устройству. Значение 0
                          (ноль) указывает на то, что программа желает проверить воз-
     DesiredAccess
                          можность доступа к объекту. В противном случае можно ис-
                          пользовать GENERIC_READ (чтение), GENERIC_WRITE (за-
                          пись) или и то и другое (оба значения объединяются при
                          помощи оператора | – логическое сложение)
                             Набор битовых флагов, указывающий на режим совместного
                          доступа к объекту. Если значение dwShareMode равно 0, совмест-
                          ный доступ к объекту запрещен. Все последующие операции, на-
                          правленные на открытие объекта, не сработают до тех пор, пока
     dwShareMode          ваша программа не закроет дескриптор. Если необходимо обеспе-
                          чить совместный доступ к файлу, используйте комбинацию фла-
                          гов     FILE_SHARE_DELETE            (совместное     удаление),
                          FILE_SHARE_READ              (совместное       чтение)        и
                          FILE_SHARE_WRITE (совместная запись)
                             Указатель на структуру SECURITY_ATTRIBUTES, которая
                          определяет, будет ли создаваемый дескриптор наследоваться
   lpSecurityAttributes
                          дочерними процессами. Если аргумент lpSecurityAttributes
                          имеет значение NULL, дескриптор не будет наследоваться
                             Указывает, каким образом следует создать (или открыть)
                          файл. Допускается использовать следующие значения:
                          CREATE_NEW (создать новый файл; если файл существует,
                          функция не срабатывает); CREATE_ALWAYS (создать новый
                          файл; если файл существует, он перезаписывается);
  dwCreationDisposition
                          OPEN_EXISTING (открыть файл; если файл не существует,
                          функция не срабатывает); OPEN_ALWAYS (открыть файл; ес-
                          ли файл не существует, он создается) или TRUN-
                          CATE_EXISTING (открыть файл и сделать его длину равной
                          нулю; если файл не существует, функция не срабатывает)
                             Набор атрибутов и флагов, которыми должен обладать файл.
                          Например, если требуется, чтобы новый файл был скрытым, ис-
                          пользуйте значение FILE_ATTRIBUTE_HIDDEN; если при работе
  dwFlagsAndAttributes    с файлом требуется отключить кэширование, используйте значе-
                          ние FILE_FLAG_NO_BUFFERING. Возможные значения флагов
                          перечислены в табл. 12.2. Здесь же можно использовать специаль-
                          ные флаги для именованных каналов
                             Содержит дескриптор с доступом GENERIC_READ. Это де-
     hTemplateFile        скриптор шаблонного файла, атрибуты которого (включая
                          расширенные) будут присвоены создаваемому файлу




                                          59