OpenFile 함수(winbase.h)

파일을 만들거나, 열거나, 다시 열거나, 삭제합니다.

구문

HFILE OpenFile(
  [in]  LPCSTR     lpFileName,
  [out] LPOFSTRUCT lpReOpenBuff,
  [in]  UINT       uStyle
);

매개 변수

[in] lpFileName

파일 이름입니다.

문자열은 8비트 Windows 문자 집합의 문자로 구성되어야 합니다. OpenFile 함수는 유니코드 파일 이름 또는 명명된 파이프 열기를 지원하지 않습니다.

[out] lpReOpenBuff

처음 열 때 파일에 대한 정보를 수신하는 OFSTRUCT 구조체에 대한 포인터입니다.

구조체는 OpenFile 함수에 대한 후속 호출에서 열려 있는 파일을 확인하는 데 사용할 수 있습니다.

OFSTRUCT 구조체에는 길이가 128자인 OFS_MAXPATHNAME 문자로 제한되는 경로 문자열 멤버가 포함되어 있습니다. 따라서 OpenFile 함수를 사용하여 경로 길이가 128자를 초과하는 파일을 열 수 없습니다. CreateFile 함수에는 이 경로 길이 제한이 없습니다.

[in] uStyle

수행할 작업입니다.

이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

반환 값

함수가 성공하면 반환 값은 파일 I/O를 수행할 때 사용할 파일 핸들을 지정합니다. 파일을 닫려면 이 핸들을 사용하여 CloseHandle 함수를 호출합니다.

함수가 실패하면 반환 값이 HFILE_ERROR. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

lpFileName 매개 변수가 파일 이름과 확장명만 지정하는 경우 이 함수는 다음 디렉터리와 표시된 순서에서 일치하는 파일을 검색합니다.

1. 애플리케이션이 로드되는 디렉터리입니다.
2. 현재 디렉터리
3. Windows 시스템 디렉터리입니다.

   GetSystemDirectory 함수를 사용하여 이 디렉터리의 경로를 가져옵니다.

4. 16비트 Windows 시스템 디렉터리입니다.

   이 디렉터리의 경로를 검색하는 함수는 없지만 검색됩니다.

5. Windows 디렉터리입니다.

   GetWindowsDirectory 함수를 사용하여 이 디렉터리의 경로를 가져옵니다.

6. PATH 환경 변수에 나열된 디렉터리입니다.

OpenFile 함수는 16비트 Windows OpenFile 함수가 지원하는 OF_SEARCH 플래그를 지원하지 않습니다. OF_SEARCH 플래그는 파일 이름에 전체 경로가 포함된 경우에도 시스템에서 일치하는 파일을 검색하도록 지시합니다. SearchPath 함수를 사용하여 파일을 검색합니다.

uStyle 매개 변수의 값이 다른 액세스 플래그가 있는 OF_DELETE 액세스 플래그 OR'ed이고 FILE_SHARE_DELETE 공유 액세스를 사용하여 원격 파일 또는 디렉터리를 열지 않은 경우 원격 컴퓨터에서 삭제를 위해 파일 또는 디렉터리를 열려고 하면 공유 위반이 발생합니다. 이 시나리오에서 공유 위반을 방지하려면 OF_DELETE 액세스만 있는 원격 파일 또는 디렉터리를 열거나 삭제를 위해 파일 또는 디렉터리를 먼저 열지 않고 DeleteFile 을 호출합니다.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

CsvF는 압축된 파일에 대해 리디렉션된 IO를 수행합니다.

요구 사항

참고 항목

CreateFile

파일 관리 함수

GetSystemDirectory

GetWindowsDirectory

OFSTRUCT

SearchPath