MSDN Windows API CreateFile 函数 中文.doc

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，那么句柄不能被继承。 Windows NT/2000/XP: 结构体lpSecurityDescriptor的成员为对象指定一个安全的描述符。如果lpSecurityAttributes为NULL，那么对象得到一个默认的安全描述符。目标文件系统必须支持在文件和目录的安全性，以支持这个参数在文件上的影响。 dwCreationDisposition 指定文件的创建方式，并且当文件不存在时指定文件的常见方式。关于这个参数的跟多信息请参考备注信息。这个参数必须赋予以下值。 参数值 描述 C