MSDN Windows API CreateFile 函数 中文

CreateFile CreateFile 函数创建或打开以下的对象并且返回一个可被对象访问的句柄 控制台 通信资源 目录 磁盘驱动 文件 邮路 管道 HANDLE CreateFile LPCTSTR lpFileName 文件名 DWORD dwDesiredAccess 访问模式 DWORD dwShareMode 共享模式 LPSECURITY ATTRIBUTES lpSecurityAttributes SD DWORD dwCreationDisposition 如何创建 DWORD dwFlagsAndAttributes 文件属性 HANDLE hTemplateFile 文件模板句柄 参数 lpFileName 指针指向一个无终止符的字符串指定对象的名称 用以创建或打开 Windows NT 2000 XP 在 ANSI 美国信息标准 版本的函数中 名称限制最大字符串 长度 要扩展这个限制以满足大约 32000 长度的字符串 使用 Unicode 统一字符编码 标准 版本的函数 并且在路径中预加 更多信息请查看文件名规则 Windows 95 98 Me 这个字符串必须不大于最大字符长度 dwDesiredAccess 指定对象的访问类型 一个应用程序可以获得读访问 写访问 读 写访问或驱动查询 访问 这个参量可以被任意的以下参数值组合 参数值参数值描述描述 0指定驱动查询访问给对象 应用程序 能在不需要驱动访问进行时查询驱动 属性 GENERIC READ指定读访问给对象 数据能够从文件 与可被移动的文件指针读入 与 GENERIC WRITE 结合可实现读 写访 问 GENERIC WRITE指定写访问给对象 数据能够被写入 文件和可移动的文件指针 与 GENERIC READ 结合可实现读 写访 问 另外 你可以定义以下的访问标志 参数值参数值文档文档 DELETE标准访问权限 READ CONTROL标准访问权限 WRITE DAC标准访问权限 WRITE OWNER标准访问权限 SYNCHRONIZE标准访问权限 STANDARD RIGHTS REQUIRED标准访问权限 STANDARD RIGHTS READ标准访问权限 STANDARD RIGHTS WRITE标准访问权限 STANDARD RIGHTS EXECUTE标准访问权限 STANDARD RIGHTS ALL标准访问权限 SPECIFIC RIGHTS ALL访问掩码 ACCESS SYSTEM SECURITY访问掩码 MAXIMUM ALLOWED访问掩码 GENERIC READ访问掩码 GENERIC WRITE访问掩码 GENERIC EXECUTE访问掩码 GENERIC ALL访问掩码 dwShareMode 指定对象如何被共享 如果dwShareMode为 0 并且创建文件成功 对象不能够被共 享和再次打开 直到句柄关闭 请参考备注部分关于共享冲突的信息 为了共享对象 使用一个或多个以下参数值的集合 参数值参数值描述描述 FILE SHARE DELETE Windows NT 2000 XP 只有当删除访问请 求时 随后在对象上的打开操作才能成功 FILE SHARE READ 只有当读访问被请求时 随后在对象上的打 开操作才能成功 FILE SHARE WRITE 只有当写访问被请求时 随后在对象上的打 开操作才能成功 lpSecurityAttributes 指针指向一个 SECURITY ATTRIBUTES 结构体决定句柄返回是否能够被子过程继承 如 果lpSecurityAttributes为 NULL 那么句柄不能被继承 WindowsWindows NT 2000 XP NT 2000 XP 结构体 lpSecurityDescriptorlpSecurityDescriptor 的成员为对象指定一个安全的描 述符 如果lpSecurityAttributes为 NULL 那么对象得到一个默认的安全描述符 目标文件系统必须支持在文件和目录的安全性 以支持这个参数在文件上的影响 dwCreationDisposition 指定文件的创建方式 并且当文件不存在时指定文件的常见方式 关于这个参数的跟 多信息请参考备注信息 这个参数必须赋予以下值 参数值参数值描述描述 CREATE NEW 建立一个新文件 如果文件已经存在 将出 现函数错误 CREATE ALWAYS 创建一个新文件 如果文件已经存在 将覆 盖原来的文件 清除现有的属性 并且用 dwFlagsAndAttributes与 FILE ATTRIBUTE ARCHIVE 混合文件属性和已 定义标志 OPEN EXISTING 打开文件 如果文件不存在 将出现函数错 误 关于为什么你需要用 OPEN EXISTING 标记如 果你正在使用 CreateFile 函数在驱动时的 讨论 请参考备注 OPEN ALWAYS 如果文件存在 打开文件 如果不存在 函 数像dwCreationDisposition为 CREATE NEW 一样创建文件 TRUNCATE EXISTING 打开文件 一旦打开 文件被截断以便使其 为 0 字节 正在调用的过程必须打开至少是 GENRIC WRITE 访问的文件 如果文件不存在 函数错误 dwFlagsAndAttributes 为文件指定文件属性和标记 在dwFlagsAndAttributes参数中 任何以下属性的组合是被接受的 所有其他文件属 性替代 FILE ATTRIBUTE NORMAL 属性除外 属性属性描述描述 FILE ATTRIBUTE ARCHIVE 文件被标记归档 应用程序使用这个属性标 记文件备份或移除 FILE ATTRIBUTE ENCRYPTED 文件或目录标记为加密 对一个文件而言 这个含义表示文件中的所有的数据被加密 对目录而言 这个含义表示对新创建的文件 和子目录加密方法为默认属性 如果 FILE ATTRIBUTE SYSTEM 也被定义 这 个标记将无影响 FILE ATTRIBUTE HIDDEN 文件为隐藏 它不包括在一个普通的目录列 表中 FILE ATTRIBUTE NORMAL 文件没有其他属性设置 当这个属性单独使 用时有效 FILE ATTRIBUTE NOT CONTENT INDEXED 文件将正在内容索引服务中被索引 FILE ATTRIBUTE OFFLINE 文件数据不能立即使用 这个属性表明文件 数据已经被物理移动至脱机存储器中 这个 属性被使用在远程存储器 分层存储器存储 管理软件中 应用程序不能随意改变此属性 FILE ATTRIBUTE READONLY 文件只读 应用程序能够读文件 但不能写 或删除文件 FILE ATTRIBUTE SYSTEM 部分文件或全部被操作系统使用 FILE ATTRIBUTE TEMPORARY 文件正在被临时存储器调用 文件系统与其 试图使在内存中的所有数据存入大容量存储 器倒不如更迅速地被访问 对dwFlagsAndAttributes参数来说 以下任何标记的组合是可以允许的 标记标记描述描述 FILE FLAG WRITE THROUGH 命令系统通过任意中级缓存并且直接写入磁 盘 系统仍能隐藏写操作 但是不能缓慢的 强制刷新 FILE FLAG OVERLAPPED 命令系统初始化对象 以获得一个有意义的 时间数值来处理 ERROR IO PENDING 返回 当操作完成 指定的设置被设置为规定信号 当你指定 FILE FLAG OVERLAPPED 文件读与 写函数必须指定为 OVERLAPPED 结构 就是 说 当 FILE FLAG OVERLAPPED 已被指定 一个应用程序必须提供异步读和写 当 FILE FLAG OVERLAPPED 已被指定 系统 不维持文件指针 文件位置以lpOverlapped 属性 指向一个 OVERLAPPED 结构 被传递 用以文件读写函数 这个标记也能使不止一个操作与句柄 例如 一个联合读与写的操作 联立地执行 FILE FLAG NO BUFFERING 命令系统不需要中间缓存或高速缓存打开文 件 当联合使用 FILE FLAG OVERLAPPED 标 记给予最大的异步性能 因为 I O 不依赖内 存管理的同步操作 然而 一些 I O 操作将 更久 因为数据不被置入高速缓存中 当运行伴随已打开文件且有 FILE FLAG NO BUFFERING 属性时 应用程序 必然出现某些必要需要 文件访问必须开始于在整数倍文件扇区 大小内的字节偏移 文件访问一定是许多整数倍文件扇区大 小的字节 例如 如果扇区大小为 512 字节 应用程序能够请求读和写 512 1024 或 2048 字节 但是不能是 335 981 或 7171 字节 缓存区地址的读写操作与扇区对齐 对 齐整数倍扇区大小的内存地址 依赖 于磁盘 这个要求可能不会被强制执行 一种调整缓冲区为整数倍扇区大小值的方法 是使用 VirtualAlloc 分配缓冲区 它调整 地址以整数倍的操作系统内存页大小分配内 存 因为内存页与扇区卷标大小二者之间后 者更高级 因此内存地址也对齐整数倍的扇 区容量大小 应用程序能通过 GetDiskFreeSpace 函数确 定扇区大小 FILE FLAG RANDOM ACCESS 指示文件随机存取 系统可以利用这个作为 优化文件缓存的提示 FILE FLAG SEQUENTIAL SCAN 指示文件从开始到结尾顺序存储 系统可以 利用这个作为优化文件缓存的提示 如果应 用程序以随机访问移动文件指针 最适合的 高速缓存不一定产生 然而 正确的操作仍 然是有保证的 在连续访问模式 定义这个标记能增强应用 程序的读大文件的性能 在应用程序读顺序 地读大文件时性能收益能甚至更显而易见 但是偶尔会跳过小字节区间 FILE FLAG DELETE ON CLOSE 指示操作系统在它的句柄被关闭后立即删除 文件 不仅仅是处理你所指定 FILE FLAG DELETE ON CLOSE 属性的句柄 随后的文件打开请求将失败 除非 FILE SHARE DELETE 被使用 FILE FLAG BACKUP SEMANTICS WindowsWindows NT 2000 XP NT 2000 XP 指示一个已被打开或 创建文件的备份或恢复 假若它已有必要的 权限 系统将确保调用过程不进行文件安全 检测 相关的权限如 SE BACKUP NAME 和 SE RESTORE NAME 你也能够设置这个标记用以获取一个目录的 句柄 一个目录句柄能够传递给一些代替文 件句柄的函数 FILE FLAG POSIX SEMANTICS 指示文件权限符合 POSIX 规则 包括假如文 件系统支持文件的多个不同名称的命名 谨 慎使用则个选项 因为使用这个标记创建文 件可能不能被 MS DOS 或 16 位 Windows 应用 程序的写操作接受 FILE FLAG OPEN REPARSE POINT 设置这个标记禁止 NTFS 解析点重新解析操 作 当文件已被打开 无论控制解析点是否 被操作 文件句柄都会被返回 这个标记不 能与 CREATE ALWAYS 标记一同使用 FILE FLAG OPEN NO RECALL 指示文件数据被请求 但是它应当贮存在远 程存储器中 它不能被存入特定的逻辑存储 器中 这个标记特别用于远程存储器系统或 远程存储器管理系统中 如果 CreateFileCreateFile 函数打开一个已命名通道的客户端 dwFlagsAndAttributes参数也 能够包含安全服务中的安全质量服务信息 更多的信息 参考 Impersonation Levels 当应用程序调用指定为 SECURITY SQOS PRESENT 标记 dwFlagsAndAttributes参数能够包含一个或多个以下的参数值 参数描述 SECURITY ANONYMOUS 指定在 Identification 模拟等级中模拟客 户端 SECURITY IDENTIFICATION 指定在 Identification 模拟等级中模拟客 户端 SECURITY IMPERSONATION 指定在 Identification 模拟等级中模拟客 户端 SECURITY DELEGATION 指定在 Delegation 模拟等级中模拟客户端 SECURITY CONTEXT TRACKING 指定安全追踪模式是动态的 如果这个标记 未被定义 安全追踪模式是静态的 SECURITY EFFECTIVE ONLY 只有当用户的安全上下文方面是可激活的 则在服务器中有效 如果你不指定这个标 记 所有的用户安全上下文是有效地 这个标记允许客户端限制分组和权限 那 么一个正在模拟客户端服务器可以使用 hTemplateFile 指示一个 GENERIC READ 句柄接受一个模版文件 这个模版文件提供正在创建文件的文 件属性与扩展属性 WindowsWindows 95 98 Me 95 98 Me hTemplateFile参数必须为 NULL 如果你提供一个句柄 则调用 失败 GetLastErrorGetLastError 返回返回 ERROR NOT SUPPORTED ReturnReturn ValuseValuse 如果函数成功 返回值是一个指定文件的打开句柄 如果指定的文件在函数调用并且 dwCreationDisposition为 CREATE ALWAYS 或 OPEN ALWAYS 之前存在 GetLastErrorGetLastError 返回 ERROR ALREADY EXISTS 即使函数是成功的 如果文件在调用前不存在 GetLastErrorGetLastError 返回 0 如果函数失败 返回值为 INVALID HANDLE VALUE 得到扩展错误信息 调用 GetLastErrorGetLastError 备注备注 使用 CloseHandleCloseHandle 函数关闭一个对象句柄 并通过 CreateFileCreateFile 返回 如以下注明 对dwDesiredAccess付 0 值 允许应用程序查询设备而不需要实际上的访问 设备 这种查询方式是有意义的 例如 如果一个应用程序想要确定磁盘驱动器的大小和 格式化支持 不需要软盘插入驱动器 WindowsWindows 95 98 ME CreateFileW95 98 ME CreateFileW 通过微软统一字符编码标准结构支持 为了使用这个标准 你必须为你的应用程序加载某些文件 如在 Windows 95 98 Me 微软同意字符编码标准结构 系统概述 WindowsWindows 2000 XP2000 XP 如果当dwDesiredAccess参数值为 DELETE 或 ed 且联同其他任何访 问标记 并且远程文件或目录没有以 FILE SHARE DELETE 共享访问时 在远程机器上为删 除一个打开文件或目录意图一个共享冲突将发生 为了避免共享冲突在这种局面中出现 只用 DELETE 访问或为了删除不在第一次打开文件或目录时调用 DeleteFileDeleteFile 打开远程文件 或目录 WindowsWindows 2000 XP2000 XP 如果 CREATE ALWAYS 作为dwCreationDisposition参数值被定义且 FILE ATTRIBUTE NORMAL 未被作为dwFlagsAndAttributes的参数值定义 CreateFileCreateFile 将失 败并设置 GetLastErrorGetLastError 错误报告给 ACCESS DENIED 假若如此 设置 dwFlagsAndAttributes的参数值中 FILE ATTRIBUTE HIDDEN 和 FILE ATTRIBUTE NORMAL 属 性为 ORed 以避免这个错误 文件文件 如果你意图在一个软盘驱动器中或在光盘驱动器中创建一个文件且不没有一个软盘或光盘 系统显示一个消息窗口告诉用户分别需要插入一个软盘或光盘 为了防止系统显示这个消 息框 联同 SEM FAILCRITICALERRORS 调用 SetErrorModeSetErrorMode 函数 当建立一个新文件时 CreateFileCreateFile 函数执行以下的操作 清除现有的文件属性 联合文件属性和被dwFlagsAndAttributes的 FILE ATTRIBUTE ARCHIVE 指定的而 标记 设置文件长度为 0 如果hTemplateFile参数被定义 复制模版文件提供的文件属性给新文件 当打开一个现有的文件时 CreateFileCreateFile 执行以下的操作 联合被现有的文件属性的dwFlagsAndAttributes 指定的标记 CreateFileCreateFile 忽略 被dwFlagsAndAttributes定义的文件属性 根据dwCreationDisposition定义的值设置文件的长度 忽略hTemplateFile参数 如果lpSecurityAttributes参数不为 NULL 忽略 SECURITYSECURITY ATTRIBUTESATTRIBUTES 结构体 的 lpSecurityDescriptorlpSecurityDescriptor 成员参数 其他结构体的成员为已用的 bInheritHandlebInheritHandle 成员是指示文件句柄是否被继承唯一的方式 WindowsWindows NT 2000 XPNT 2000 XP 如果你重命名或删除一个文件 那么随后恢复它 系统搜寻缓 存文件信息以恢复 隐藏信息包含它的长 短名称对和创建时间 WindowsWindows NT 2000 XPNT 2000 XP 文件系统 如 NTFS 支持个别文件和目录压缩或加密 在格式 化卷标这样一个文件系统中 一个文件继承它的目录压缩与加密属性 你不能使用 CreateFileCreateFile 函数以设置一个文件的压缩状态 使用 DeviecIoControlDeviecIoControl 函数 以设置文件压缩状态 当多数过程想要打开相同的文件 或者单个过程想要几次打开文件 如果第二次并且 随后的操作定义任意一个共享模式与第一次打开方式访问模式定义不同 一个共享冲 突将在文件打开的第一时间发生 换句话说 Windows 不能允许在多次单个文件的打 开操作中的共享模式请求冲突 两个关于共享冲突的例子如下 如果在第一次调用 CreateFileCreateFile 时定义 GENERIC READ GENERIC WRITE 访问模 式与 FILE SHARE READ 共享模式 如果你在第二次调用 CreateFileCreateFile 时定义了 GENERIC WRITE 访问模式 那么函数将因为一个共享冲突而失败 原因是第 一次调用打开文件时为仅仅读模式 如果在第一次调用 CreateFileCreateFile 时定义 GENERIC READ GENERIC WRITE 访问模 式 FILE SHARE READ 和 FILE SHARE WRITE 共享模式 如果在第二次调用 CreateFileCreateFile 时仅定义 GENERIC READ GENERIC WRITE 访问模式和 FILE SHARE READ 共享模式 函数将因为一个共享冲突失败 原因是第二次 调用与读 写访问与第一次赋予的仅仅读共享模式冲突 管道管道 如果 CreateFileCreateFile 打开一个完成于已命名管道的客户端 函数使用任何已命名管道的实例监 听状态 开放的过程能按需多次复制句柄 一旦打开 已命名的管道实例不能被其他客户 端打开 当一个管道被打开时 其打访问定义必须与 CreateNamedPipeCreateNamedPipe 函数dwOpenMode参 数的访问定义不同 更多关于管道的信息 参考 Pipes 邮槽邮槽 如果 CreateFileCreateFile 打开一个完成于邮槽的客户端 如果在包括 CreateMailSlotCreateMailSlot 函数的邮槽 服务被创建以前邮槽客户端企图打开一个逻辑邮槽时 函数返回 INVALID HANDLE VALUE 更多关于邮槽的信息 参考 Mailslots 通信资源通信资源 CreateFileCreateFile 函数能为通信资源创建一个句柄 如串口 COM1 对通信资源来说 dwCreationDisposition参数必须为 OPEN EXISTING 并且hTemplate参数必须为 NULL 读 写或读 写访问能被定义 且对异步 I O 句柄可以被打开 更多关于通信的信息 参考 Communications 磁盘驱动器 卷标句柄可能被当做文件系统任凭不进行缓存打开 即使当不进行缓存选项没有被 CreateFileCreateFile 定义 你应该假定微软文件系统以不缓存打开卷标句柄 文件的不进行缓存的 I O 限制也适用于卷标 WindowsWindows NT 2000 XPNT 2000 XP 你能使用 CreateFileCreateFile 函数以打开一个磁盘驱动器或在一个磁盘驱动 器上的分区 函数给磁盘驱动器返回一个句柄 这个句柄能同 DeviceIOControl 函数被使 用 以下的必要条件必须被关注以调用成功 对操作来说调用程序必须有管理权限以在硬盘驱动器以调用成功 lpFileName应该被格式为 PHYSICALDRIVEx PHYSICALDRIVEx 字符串以以打开硬盘 x 硬盘成员开 始于 0 例如 字符串字符串含义含义 PHYSICALDRIVE2 PHYSICALDRIVE2 在用户计算机中 从第三个物理驱动器获得 一个句柄 如何打开一个物理驱动器的实例 参考 Calling DeviceIoControl on Windows NT 2000 lpFileName字符串应该为 x x 以打开软盘驱动器 x 或在硬盘上的 x 分区 例 如 字符串字符串含义含义 A 在用户计算机上获得一个驱动器 A 的句柄 C 在用户计算机上获得一个驱动器 C 的句柄 在一个驱动器名最后没有反斜杠 字符串 c 表示 C 驱动器下的根目录 在 Windows 2000 或更早版本中 你也可以打开一个卷标通过它的唯一的卷标名 假若如此 那么在唯一的卷标明后没有最后反斜杠 所有的 I O 缓存应该与扇区对齐 在内存中对齐地址为整数倍的扇区容量大小 甚至如 果磁盘驱动器没有 FLIE FLAG NO BUFFERING 标记被打开 依赖磁盘这个要求可能不被强制 WindowsWindows 95 98 ME95 98 ME 在打开逻辑驱动器时 这个技术不运作 指定一个格式化的字符串导 致 CreateFileCreateFile 返回一个错误 dwCreationDisposition参数必须包含 OPEN EXISTING 值 当打开一个软盘驱动器或一个硬盘分区 你必须在dwShareMode参数中设置 FILE SHARE WRITE 标记 磁带驱动器磁带驱动器 WindowsWindows NT 2000 XPNT 2000 XP 你能可以使用一个格式化的文件名 TAREx TAREx 打开磁带驱动器 x 是一个数值指针要打开的驱动器 起始为磁带驱动器 0 为在 C 中打开磁带驱动器 0 使用 文件名 TAPE0 更多关于备份磁带驱动器或应用程序的信息 参考 Tape Backup 控制台控制台 CreateFileCreateFile 函数能为控制台输入 CONIN 创建一个句柄 如果进程存在一个打开的句柄 作为继承或复制的结果的结果 它也能为活动的屏幕缓存 CONOUT 创建一个句柄 正在调 用的进程必须属于一个继承控制台或通过 AllocConsoleAllocConsole 函数分配 对控制台句柄来说 如 下设置 CreateFileCreateFile 参数 参数值 lpFileName 使用 CONIN 值已定义控制台输入并使用 CONOUT 值已控制输出 CONIN 为控制台的输入缓存获得一个句柄 即使如果 SetStdHandleSetStdHandle 函数重新定义输入 句柄的标准 为了的得到输入句柄的标准 使用 GetStdHandleGetStdHandle 函数 CONOUT 为活动屏幕缓存获得一个句柄 即 使 SetStdHandleSetStdHandle 已重定了输出句柄的标准 为了获得这个输出句柄标准 使用 GetStdHandle GetStdHandle dwDesiredAccess GENERIC READ GENERIC WRITE 为首选项 但是选择二者其一能限制访问 dwShareMode 如果正在调用的程序继承控制台或一个子程 序能够访问控制台 这个参数必须设置为 FILE SHARE READ FILE SHARE WRITE lpSecurityAttributes 如果你想要控制台被继承 SECURITYSECURITY ATTRIBUTESATTRIBUTES 的 bInheritHandlebInheritHandle 成员结构体 必须为真 dwCreationDisposition 当使用 CreateFileCreateFile 打开控制台时 你需要 定义为 OPEN EXISTING dwFlagsAndAttributes 忽略 hTemplateFile 忽略 以下列表显示了fwdAccess与lpFileName的各种设置的结果 lpFileNamelpFileNamefwdAccessfwdAccess 结果结果 CONGENERIC READ 以输入打开控制台 CONGENERIC WRITE 以输出打开控制台 CONGENERIC READ GENERIC WRITE WindowsWindows 95 98 Me 95 98 Me 致使 CreateFileCreateFile 失败 GetLastErrorGetLastError 返回 ERROR PATH NOT FOUND WindowsW