다음을 통해 공유


CreateFileTransactedA 함수(winbase.h)

[Microsoft는 개발자가 애플리케이션의 요구 사항을 달성하기 위해 대체 수단을 활용하는 것이 좋습니다. TxF가 개발된 많은 시나리오는 더 간단하고 쉽게 사용할 수 있는 기술을 통해 달성할 수 있습니다. 또한 이후 버전의 Microsoft Windows에서는 TxF를 사용하지 못할 수도 있습니다. TxF에 대한 자세한 내용과 대안은 트랜잭션 NTFS 사용에 대한 대안을 참조하세요.]

트랜잭션 작업으로 파일, 파일 스트림 또는 디렉터리를 만들거나 엽니다. 함수는 개체에 액세스하는 데 사용할 수 있는 핸들을 반환합니다.

이 작업을 변환되지 않은 작업으로 수행하거나 파일 이외의 개체(예: 명명된 파이프, 물리적 디바이스, mailslots)에 액세스하려면 CreateFile 함수를 사용합니다.

트랜잭션에 대한 자세한 내용은 이 항목의 설명 섹션을 참조하세요.

구문

HANDLE CreateFileTransactedA(
  [in]           LPCSTR                lpFileName,
  [in]           DWORD                 dwDesiredAccess,
  [in]           DWORD                 dwShareMode,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           DWORD                 dwCreationDisposition,
  [in]           DWORD                 dwFlagsAndAttributes,
  [in, optional] HANDLE                hTemplateFile,
  [in]           HANDLE                hTransaction,
  [in, optional] PUSHORT               pusMiniVersion,
                 PVOID                 lpExtendedParameter
);

매개 변수

[in] lpFileName

만들거나 열 개체의 이름입니다.

개체는 로컬 컴퓨터에 있어야 합니다. 그렇지 않으면 함수가 실패하고 마지막 오류 코드가 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE 설정됩니다.

기본적으로 이름은 MAX_PATH 문자로 제한됩니다. 이 제한을 와이드 문자 32,767자로 확장하려면 경로 앞에 "\\?\"를 추가합니다. 자세한 내용은 파일 이름 지정, 경로 및 네임스페이스를 참조하세요.

Windows 10 버전 1607부터 "\\?\" 앞에 추가하지 않고 MAX_PATH 제한을 제거하도록 옵트인할 수 있습니다. 자세한 내용은 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을 참조하세요.

파일 스트림을 만들려면 파일 이름, 콜론 및 스트림 이름을 지정합니다. 자세한 내용은 파일 스트림을 참조하세요.

[in] dwDesiredAccess

읽기, 쓰기, 둘 다 또는 둘 다(0)로 요약할 수 있는 개체에 대한 액세스입니다. 가장 일반적으로 사용되는 값은 GENERIC_READ, GENERIC_WRITE 또는 둘 다(GENERIC_READ GENERIC_WRITE | )입니다. 자세한 내용은 일반 액세스 권한파일 보안 및 액세스 권한을 참조하세요.

이 매개 변수가 0인 경우 애플리케이션은 해당 파일 또는 디바이스에 액세스하지 않고 파일, 디렉터리 또는 디바이스 특성을 쿼리할 수 있습니다. 자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

열린 핸들이 있는 열린 요청에 지정된 공유 모드와 충돌하는 액세스 모드를 요청할 수 없습니다. 자세한 내용은 파일 만들기 및 열기를 참조하세요.

[in] dwShareMode

개체의 공유 모드로, 읽기, 쓰기, 모두 삭제, 이러한 모든 항목 또는 없음(다음 표 참조)입니다.

이 매개 변수가 0이고 CreateFileTransacted가 성공하면 개체를 공유할 수 없으며 핸들이 닫혀 있을 때까지 다시 열 수 없습니다. 자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

열려 있는 핸들이 있는 열린 요청에 지정된 액세스 모드와 충돌하는 공유 모드를 요청할 수 없습니다. 그러면 공유 위반이 발생하므로 ERROR_SHARING_VIOLATION. 자세한 내용은 파일 만들기 및 열기를 참조하세요.

다른 프로세스에서 개체가 열려 있는 동안 프로세스에서 개체를 공유할 수 있도록 하려면 다음 값 중 하나 이상을 조합하여 개체 열기를 요청할 수 있는 액세스 모드를 지정합니다.

참고 열려 있는 각 핸들에 대한 공유 옵션은 프로세스 컨텍스트에 관계없이 해당 핸들이 닫혀 있을 때까지 계속 적용됩니다.
 
의미
0
0x00000000
개체에 대한 모든 형식의 액세스를 요청하기 위해 개체에 대한 후속 열기 작업을 사용하지 않도록 설정합니다.
FILE_SHARE_DELETE
0x00000004
개체에 대한 후속 열기 작업을 사용하여 액세스 삭제를 요청할 수 있습니다.

그렇지 않으면 다른 프로세스에서 삭제 액세스를 요청하는 경우 개체를 열 수 없습니다.

이 플래그를 지정하지 않았지만 개체가 삭제 액세스를 위해 열려 있으면 함수가 실패합니다.

FILE_SHARE_READ
0x00000001
개체에 대한 후속 열기 작업을 사용하여 읽기 액세스를 요청할 수 있습니다.

그렇지 않으면 다른 프로세스에서 읽기 액세스를 요청하는 경우 개체를 열 수 없습니다.

이 플래그를 지정하지 않았지만 읽기 액세스를 위해 개체가 열려 있으면 함수가 실패합니다.

FILE_SHARE_WRITE
0x00000002
개체에 대한 후속 열기 작업을 사용하여 쓰기 액세스를 요청할 수 있습니다.

그렇지 않으면 다른 프로세스에서 쓰기 액세스를 요청하는 경우 개체를 열 수 없습니다.

이 플래그를 지정하지 않았지만 개체가 쓰기 액세스를 위해 열렸거나 쓰기 액세스 권한이 있는 파일 매핑이 있는 경우 함수가 실패합니다.

[in, optional] lpSecurityAttributes

선택적 보안 설명자를 포함하고 반환된 핸들을 자식 프로세스에서 상속할 수 있는지 여부를 결정하는 SECURITY_ATTRIBUTES 구조체에 대한 포인터입니다. 매개 변수는 NULL일 수 있습니다.

lpSecurityAttributes 매개 변수가 NULL인 경우 CreateFileTransacted에서 반환된 핸들은 애플리케이션이 만들 수 있는 자식 프로세스에서 상속할 수 없으며 반환된 핸들과 연결된 개체는 기본 보안 설명자를 가져옵니다.

구조체의 bInheritHandle 멤버는 반환된 핸들을 상속할 수 있는지 여부를 지정합니다.

구조체의 lpSecurityDescriptor 멤버는 개체에 대한 보안 설명자를 지정하지만 NULL일 수도 있습니다.

lpSecurityDescriptor 멤버가 NULL인 경우 반환된 핸들과 연결된 개체에 기본 보안 설명자가 할당됩니다.

CreateFileTransacted 는 기존 파일을 열 때 lpSecurityDescriptor 멤버를 무시하지만 bInheritHandle 멤버를 계속 사용합니다.

자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

[in] dwCreationDisposition

존재하고 존재하지 않는 파일에 대해 수행할 작업입니다.

자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

이 매개 변수는 결합할 수 없는 다음 값 중 하나여야 합니다.

의미
CREATE_ALWAYS
2
항상 새 파일을 만듭니다.

지정된 파일이 있고 쓸 수 있는 경우 함수는 파일을 잘라내고, 함수는 성공하고, 마지막 오류 코드는 ERROR_ALREADY_EXISTS (183)로 설정됩니다.

지정된 파일이 존재하지 않고 유효한 경로인 경우 새 파일이 만들어지고 함수가 성공하며 마지막 오류 코드가 0으로 설정됩니다.

자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

CREATE_NEW
1
새 파일이 없는 경우에만 새 파일을 만듭니다.

지정된 파일이 있으면 함수가 실패하고 마지막 오류 코드가 ERROR_FILE_EXISTS (80)로 설정됩니다.

지정된 파일이 존재하지 않고 쓰기 가능한 위치에 대한 유효한 경로인 경우 새 파일이 만들어집니다.

OPEN_ALWAYS
4
항상 파일을 엽니다.

지정된 파일이 있으면 함수가 성공하고 마지막 오류 코드가 ERROR_ALREADY_EXISTS (183)로 설정됩니다.

지정된 파일이 존재하지 않고 쓰기 가능한 위치에 대한 유효한 경로인 경우 함수는 파일을 만들고 마지막 오류 코드는 0으로 설정됩니다.

OPEN_EXISTING
3
파일 또는 디바이스가 있는 경우에만 엽니다.

지정된 파일이 없으면 함수가 실패하고 마지막 오류 코드가 ERROR_FILE_NOT_FOUND (2)로 설정됩니다.

자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

TRUNCATE_EXISTING
5
파일을 열고 파일이 있는 경우에만 크기가 0바이트가 되도록 자립니다.

지정된 파일이 없으면 함수가 실패하고 마지막 오류 코드가 ERROR_FILE_NOT_FOUND (2)로 설정됩니다.

호출 프로세스는 dwDesiredAccess 매개 변수의 일부로 설정된 GENERIC_WRITE 비트로 파일을 열어야 합니다.

[in] dwFlagsAndAttributes

가장 일반적인 기본값인 FILE_ATTRIBUTE_NORMAL 파일 특성 및 플래그입니다.

이 매개 변수는 사용 가능한 파일 특성(FILE_ATTRIBUTE_*)의 조합을 포함할 수 있습니다. 다른 모든 파일 특성은 FILE_ATTRIBUTE_NORMAL 재정의합니다.

이 매개 변수는 버퍼링 동작, 액세스 모드 및 기타 특수 용도 플래그를 제어하기 위한 플래그(FILE_FLAG_)의 조합을 포함할 수도 있습니다. 이러한 값은 모든 FILE_ATTRIBUTE_ 값과 결합합니다.

이 매개 변수는 SECURITY_SQOS_PRESENT 플래그를 지정하여 SQOS(보안 서비스 품질) 정보를 포함할 수도 있습니다. 특성 및 플래그 테이블에 따라 테이블에 추가 SQOS 관련 플래그 정보가 표시됩니다.

참고  

CreateFileTransacted가 기존 파일을 열면 일반적으로 파일 플래그를 기존 파일의 파일 특성과 결합하고 dwFlagsAndAttributes의 일부로 제공된 모든 파일 특성을 무시합니다. 특수 사례는 파일 만들기 및 열기에 자세히 설명되어 있습니다.

 
다음 파일 특성 및 플래그는 CreateFileTransacted 가 열리는 다른 형식의 개체가 아닌 파일 개체에만 사용됩니다(이 항목의 설명 섹션에서 추가 정보를 찾을 수 있음). 파일 특성에 대한 고급 액세스는 SetFileAttributes를 참조하세요. 해당 값과 설명이 포함된 모든 파일 특성의 전체 목록은 파일 특성 상수를 참조하세요.
attribute 의미
FILE_ATTRIBUTE_ARCHIVE
32 (0x20)
파일을 보관해야 합니다. 애플리케이션은 이 특성을 사용하여 파일을 백업 또는 제거로 표시합니다.
FILE_ATTRIBUTE_ENCRYPTED
16384 (0x4000)
파일이나 디렉터리가 암호화되어 있습니다. 파일의 경우 파일의 모든 데이터가 암호화됨을 의미합니다. 디렉터리의 경우 암호화가 새로 만든 파일 및 하위 디렉터리의 기본값임을 의미합니다. 자세한 내용은 파일 암호화를 참조하세요.

FILE_ATTRIBUTE_SYSTEM 지정한 경우에도 이 플래그는 영향을 주지 않습니다.

FILE_ATTRIBUTE_HIDDEN
2 (0x2)
파일이 숨겨져 있습니다. 일반 디렉터리 목록에 포함하지 마세요.
FILE_ATTRIBUTE_NORMAL
128 (0x80)
파일에는 다른 특성이 설정되어 있지 않습니다. 이 특성은 단독으로 사용될 때만 유효합니다.
FILE_ATTRIBUTE_OFFLINE
4096 (0x1000)
파일의 데이터를 즉시 사용할 수 없습니다. 이 특성은 파일 데이터가 오프라인 스토리지로 물리적으로 이동되었음을 나타냅니다. 이 특성은 계층적 스토리지 관리 소프트웨어인 Remote Storage에서 사용됩니다. 애플리케이션이 이 특성을 임의로 변경해서는 안 됩니다.
FILE_ATTRIBUTE_READONLY
1 (0x1)
파일은 읽기 전용입니다. 애플리케이션은 파일을 읽을 수 있지만 파일을 쓰거나 삭제할 수는 없습니다.
FILE_ATTRIBUTE_SYSTEM
4 (0x4)
파일은 운영 체제의 일부이거나 단독으로 사용됩니다.
FILE_ATTRIBUTE_TEMPORARY
256 (0x100)
파일이 임시 스토리지에 사용되고 있습니다. 핸들이 닫힌 후 애플리케이션이 임시 파일을 삭제하기 때문에 충분한 캐시 메모리를 사용할 수 있는 경우 파일 시스템은 대량 스토리지에 데이터를 다시 쓰지 않습니다. 이 경우 시스템은 데이터 쓰기를 완전히 방지할 수 있습니다. 그러지 않으면 핸들이 닫힌 후 데이터가 기록됩니다.
 
플래그 의미
FILE_FLAG_BACKUP_SEMANTICS
0x02000000
백업 또는 복원 작업을 위해 파일을 열거나 만들고 있습니다. 시스템은 프로세스에 SE_BACKUP_NAME 및SE_RESTORE_NAME 권한이 있는 경우 호출 프로세스가 파일 보안 검사를 재정의하도록 합니다. 자세한 내용은 토큰의 권한 변경을 참조하세요.

디렉터리에 대한 핸들을 가져오려면 이 플래그를 설정해야 합니다. 디렉터리 핸들은 파일 핸들 대신 일부 함수에 전달할 수 있습니다. 자세한 내용은 디렉터리 핸들을 참조하세요.

FILE_FLAG_DELETE_ON_CLOSE
0x04000000
트랜잭션이 여전히 활성 상태인 경우 파일에 대한 마지막 트랜잭션 기록기 핸들을 닫은 직후에 파일을 삭제해야 합니다. 파일이 삭제로 표시되어 있고 트랜잭션이 완료된 후에도 트랜잭션된 기록기 핸들이 여전히 열려 있으면 파일이 삭제되지 않습니다.

파일에 대한 기존 열린 핸들이 있는 경우 FILE_SHARE_DELETE 공유 모드로 열려 있지 않으면 호출이 실패합니다.

FILE_SHARE_DELETE 공유 모드가 지정되지 않은 경우에는 파일에 대한 후속 열기 요청이 실패합니다.

FILE_FLAG_NO_BUFFERING
0x20000000
시스템 캐싱 없이 파일이 열립니다. 이 플래그는 하드 디스크 캐싱 또는 메모리 매핑된 파일에 영향을 주지 않습니다. FILE_FLAG_OVERLAPPED 결합하면 I/O가 메모리 관리자의 동기 작업에 의존하지 않으므로 플래그는 최대 비동기 성능을 제공합니다. 그러나 데이터가 캐시에 저장되지 않으므로 일부 I/O 작업에는 더 많은 시간이 소요됩니다. 또한 파일 메타데이터는 여전히 캐시될 수 있습니다. 메타데이터를 디스크로 플러시하려면 FlushFileBuffers 함수를 사용합니다.

애플리케이션은 FILE_FLAG_NO_BUFFERING 열린 파일로 작업할 때 특정 요구 사항을 충족해야 합니다.

  • 파일 액세스는 볼륨 섹터 크기의 정수 배수인 파일 내의 바이트 오프셋에서 시작해야 합니다.
  • 파일 액세스는 볼륨 섹터 크기의 정수 배수인 바이트 수여야 합니다. 예를 들어 섹터 크기가 512바이트인 경우 애플리케이션은 512, 1024, 1536 또는 2048바이트의 읽기 및 쓰기를 요청할 수 있지만 335, 981 또는 7171 바이트는 요청할 수 없습니다.
  • 읽기 및 쓰기 작업의 버퍼 주소는 섹터에 맞춰야 합니다. 즉, 볼륨 섹터 크기의 정수 배수인 메모리의 주소에 맞춰야 합니다. 디스크에 따라 이 요구 사항이 적용되지 않을 수 있습니다.
볼륨 섹터 크기의 정수 배수에 버퍼를 맞추는 한 가지 방법은 VirtualAlloc 을 사용하여 버퍼를 할당하는 것입니다. 운영 체제의 메모리 페이지 크기의 정수 배수인 주소에 맞춰진 메모리를 할당합니다. 메모리 페이지와 볼륨 섹터 크기는 모두 2의 힘이므로 이 메모리는 볼륨 섹터 크기의 정수 배수인 주소에서도 정렬됩니다. 메모리 페이지의 크기는 4~8KB입니다. 섹터는 512바이트(하드 디스크), 2048바이트(CD) 또는 4096바이트(하드 디스크)이므로 볼륨 섹터는 메모리 페이지보다 클 수 없습니다.

애플리케이션은 GetDiskFreeSpace 함수를 호출하여 볼륨 섹터 크기를 결정할 수 있습니다.

FILE_FLAG_OPEN_NO_RECALL
0x00100000
파일 데이터는 요청되지만 원격 스토리지에 계속 있어야 합니다. 로컬 스토리지로 다시 전송해서는 안 됩니다. 이 플래그는 원격 스토리지 시스템에서 사용하기 위한 것입니다.
FILE_FLAG_OPEN_REPARSE_POINT
0x00200000
일반적인 재문 분석 지점 처리는 발생하지 않습니다. CreateFileTransacted 는 재분석 지점을 열려고 시도합니다. 파일을 열면 재분석 지점을 제어하는 필터가 작동하는지 여부에 관계없이 파일 핸들이 반환됩니다. 이 플래그는 CREATE_ALWAYS 플래그와 함께 사용할 수 없습니다. 파일이 재분석 지점이 아닌 경우 이 플래그는 무시됩니다.
FILE_FLAG_OVERLAPPED
0x40000000
비동기 I/O를 위해 파일을 열거나 만듭니다. 작업이 완료되면 OVERLAPPED 구조에 지정된 이벤트가 신호 상태로 설정됩니다. 반환 ERROR_IO_PENDING 처리하는 데 상당한 시간이 걸리는 작업입니다.

이 플래그를 지정하면 파일을 동시 읽기 및 쓰기 작업에 사용할 수 있습니다. 시스템에서 파일 포인터를 유지 관리하지 않으므로 파일 위치를 OVERLAPPED 구조의 읽기 및 쓰기 함수에 전달하거나 파일 포인터를 업데이트해야 합니다.

이 플래그를 지정하지 않으면 읽기 및 쓰기 함수에 대한 호출이 OVERLAPPED 구조를 지정하더라도 I/O 작업이 직렬화됩니다.

FILE_FLAG_POSIX_SEMANTICS
0x01000000
파일은 POSIX 규칙에 따라 액세스해야 합니다. 여기에는 이름 지정을 지원하는 파일 시스템에 대해서만 이름이 다른 여러 파일을 허용하는 것이 포함됩니다. 이 플래그로 만든 파일은 MS-DOS 또는 16비트 Windows용으로 작성된 애플리케이션에서 액세스할 수 없으므로 이 옵션을 사용할 때는 주의해야 합니다.
FILE_FLAG_RANDOM_ACCESS
0x10000000
파일에 임의로 액세스해야 합니다. 시스템에서는 이 필드를 힌트로 사용하여 파일 캐싱을 최적화할 수 있습니다.
FILE_FLAG_SESSION_AWARE
0x00800000
세션 인식으로 파일 또는 디바이스가 열리고 있습니다. 이 플래그를 지정하지 않으면 세션 0에서 실행되는 프로세스에서 세션별 디바이스(예: RemoteFX USB 리디렉션을 사용하는 디바이스)를 열 수 없습니다. 이 플래그는 세션 0에 없는 호출자에게는 영향을 주지 않습니다. 이 플래그는 Windows 서버 버전에서만 지원됩니다.

Windows Server 2008 R2 및 Windows Server 2008: 이 플래그는 Windows Server 2012 전에 지원되지 않습니다.

FILE_FLAG_SEQUENTIAL_SCAN
0x08000000
파일은 처음부터 끝까지 순차적으로 액세스해야 합니다. 시스템에서는 이 필드를 힌트로 사용하여 파일 캐싱을 최적화할 수 있습니다. 애플리케이션이 임의 액세스를 위해 파일 포인터를 이동하는 경우 최적의 캐싱이 발생하지 않을 수 있습니다. 그러나 올바른 작업은 여전히 보장됩니다.

이 플래그를 지정 순차적 액세스를 사용 하 여 큰 파일을 읽는 애플리케이션의 성능을 향상 시킬 수 있습니다. 성능 향상을 훨씬 더 큰 파일을 주로 순차적으로 읽을 하지만 작은 범위의 바이트를 건너뛰는 경우에 따라 애플리케이션에 대 한 눈에 띄는 될 수 있습니다.

파일 시스템에서 캐시된 I/O 및 FILE_FLAG_NO_BUFFERING 지원하지 않는 경우에는 이 플래그가 적용되지 않습니다.

FILE_FLAG_WRITE_THROUGH
0x80000000
쓰기 작업은 중간 캐시를 거치지 않고 디스크로 직접 이동합니다.

시스템 캐싱이 적용되도록 FILE_FLAG_NO_BUFFERING 지정하지 않으면 데이터가 시스템 캐시에 기록되지만 지연 없이 디스크로 플러시됩니다.

시스템 캐싱이 적용되지 않도록 FILE_FLAG_NO_BUFFERING 지정한 경우 시스템 캐시를 거치지 않고 데이터가 디스크로 즉시 플러시됩니다. 또한 운영 체제는 영구 미디어에 대한 하드 디스크 캐시 쓰기를 요청합니다. 그러나 모든 하드웨어가 이 쓰기 기능을 지원하는 것은 아닙니다.

 

dwFlagsAndAttributes 매개 변수는 보안 서비스 품질 정보를 지정할 수도 있습니다. 자세한 내용은 가장 수준을 참조하세요. 호출 애플리케이션이 dwFlagsAndAttributes의 일부로 SECURITY_SQOS_PRESENT 플래그를 지정하는 경우 다음 값 중 하나 이상을 포함할 수도 있습니다.

보안 플래그 의미
SECURITY_ANONYMOUS
익명 가장 수준에서 클라이언트를 가장합니다.
SECURITY_CONTEXT_TRACKING
보안 추적 모드는 동적입니다. 이 플래그를 지정하지 않으면 보안 추적 모드가 정적입니다.
SECURITY_DELEGATION
위임 가장 수준에서 클라이언트를 가장합니다.
SECURITY_EFFECTIVE_ONLY
클라이언트 보안 컨텍스트의 사용 가능한 측면만 서버에서 사용할 수 있습니다. 이 플래그를 지정하지 않으면 클라이언트 보안 컨텍스트의 모든 측면을 사용할 수 있습니다.

이렇게 하면 클라이언트가 클라이언트를 가장하는 동안 서버에서 사용할 수 있는 그룹 및 권한을 제한할 수 있습니다.

SECURITY_IDENTIFICATION
ID 가장 수준에서 클라이언트를 가장합니다.
SECURITY_IMPERSONATION
가장 수준에서 클라이언트를 가장합니다. SECURITY_SQOS_PRESENT 플래그와 함께 다른 플래그를 지정하지 않으면 기본 동작입니다.

[in, optional] hTemplateFile

GENERIC_READ 액세스 권한이 있는 템플릿 파일에 대한 유효한 핸들입니다. 템플릿 파일은 생성되는 파일에 대한 파일 특성 및 확장 특성을 제공합니다. 이 매개 변수는 NULL일 수 있습니다.

기존 파일을 열 때 CreateFileTransacted는 템플릿 파일을 무시합니다.

새 EFS 암호화 파일을 열 때 파일은 부모 디렉터리에서 DACL을 상속합니다.

[in] hTransaction

트랜잭션에 대한 핸들입니다. 이 핸들은 CreateTransaction 함수에 의해 반환됩니다.

[in, optional] pusMiniVersion

열 미니버전입니다. hTransaction에 지정된 트랜잭션이 파일을 수정하는 트랜잭션이 아닌 경우 이 매개 변수는 NULL이어야 합니다. 그렇지 않으면 이 매개 변수는 FSCTL_TXFS_CREATE_MINIVERSION 컨트롤 코드에서 반환하는 미니버전 식별자이거나 다음 값 중 하나일 수 있습니다.

의미
TXFS_MINIVERSION_COMMITTED_VIEW
0x0000
마지막 커밋 기준으로 파일의 뷰입니다.
TXFS_MINIVERSION_DIRTY_VIEW
0xFFFF
트랜잭션에 의해 수정되는 파일의 뷰입니다.
TXFS_MINIVERSION_DEFAULT_VIEW
0xFFFE
컨텍스트에 따라 파일의 커밋된 보기 또는 더티 보기입니다. 파일을 수정하는 트랜잭션은 더티 보기를 가져오고 파일을 수정하지 않는 트랜잭션은 커밋된 뷰를 가져옵니다.

lpExtendedParameter

이 매개 변수는 예약되어 있으며 NULL이어야 합니다.

반환 값

함수가 성공하면 반환 값은 지정된 파일, 디바이스, 명명된 파이프 또는 메일 슬롯에 대한 열린 핸들입니다.

함수가 실패하는 경우 반환 값은 INVALID_HANDLE_VALUE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

CreateFileTransacted에서 반환된 핸들을 사용하는 경우 적절한 경우 표준 파일 I/O 함수 대신 트랜잭션된 버전의 파일 I/O 함수를 사용합니다. 자세한 내용은 트랜잭션 NTFS에 대한 프로그래밍 고려 사항을 참조하세요.

트랜잭션된 핸들을 디렉터리에 열 때 해당 핸들에는 FILE_WRITE_DATA(FILE_ADD_FILE) 및 FILE_APPEND_DATA(FILE_ADD_SUBDIRECTORY) 권한이 있어야 합니다. 이러한 항목은 FILE_GENERIC_WRITE 권한에 포함됩니다. 핸들을 사용하여 파일 또는 하위 디렉터리를 만드는 경우 권한이 적은 디렉터리를 열어야 합니다. 그렇지 않으면 공유 위반이 발생할 수 있습니다.

해당 파일이 다른 트랜잭션의 일부인 경우 ( 즉, 다른 애플리케이션이 CreateFileTransacted를 호출하여 파일을 연 경우) FILE_EXECUTE 액세스 수준이 있는 파일을 열 수 없습니다. 즉, 액세스 수준 FILE_EXECUTE 또는 FILE_ALL_ACCESS 지정된 경우 CreateFileTransacted가 실패합니다.

트랜잭션되지 않은 애플리케이션이 lpSecurityAttributes에 지정된 MAXIMUM_ALLOWED사용하여 CreateFileTransacted를 호출하면 매번 동일한 액세스 수준으로 핸들이 열립니다. 트랜잭션된 애플리케이션이 lpSecurityAttributes에 지정된 MAXIMUM_ALLOWED사용하여 CreateFileTransacted를 호출하면 트랜잭션에 의해 파일이 잠겨 있는지 여부에 따라 액세스 양이 다른 핸들이 열립니다. 예를 들어 호출하는 애플리케이션에 파일에 대한 FILE_EXECUTE 액세스 수준이 있는 경우 열려 있는 파일이 트랜잭션에 의해 잠기지 않거나 트랜잭션에 의해 잠겨 있고 애플리케이션이 이미 해당 파일에 대해 거래된 판독기인 경우에만 이 액세스 권한을 얻습니다.

트랜잭션 작업에 대한 전체 설명은 트랜잭션 NTFS 를 참조하세요.

CloseHandle 함수를 사용하여 핸들이 더 이상 필요하지 않고 트랜잭션을 커밋하거나 롤백하기 전에 CreateFileTransacted에서 반환된 개체 핸들을 닫습니다.

NTFS 파일 시스템과 같은 일부 파일 시스템은 개별 파일 및 디렉터리에 대한 압축 또는 암호화를 지원합니다. 이러한 종류의 파일 시스템에 대해 형식이 지정된 볼륨에서 새 파일은 해당 디렉터리의 압축 및 암호화 특성을 상속합니다.

CreateFileTransacted를 사용하여 파일 또는 디렉터리에 대한 압축을 제어할 수 없습니다. 자세한 내용은 파일 압축 및 압축 해제 및파일 암호화를 참조하세요.

바로 가기 링크 동작 - 이 함수를 호출하면 새 파일이 만들어지면 동작이 변경되지 않습니다.

FILE_FLAG_OPEN_REPARSE_POINT 지정된 경우:

  • 기존 파일이 열렸으며 바로 가기 링크인 경우 반환되는 핸들은 바로 가기 링크에 대한 핸들입니다.
  • TRUNCATE_EXISTING 또는 FILE_FLAG_DELETE_ON_CLOSE 지정된 경우 영향을 받는 파일은 기호 링크입니다.
FILE_FLAG_OPEN_REPARSE_POINT 지정되지 않은 경우:
  • 기존 파일이 열려 있고 바로 가기 링크인 경우, 반환되는 핸들은 대상에 대한 핸들입니다.
  • CREATE_ALWAYS, TRUNCATE_EXISTING 또는 FILE_FLAG_DELETE_ON_CLOSE가 지정된 경우, 영향을 받는 파일이 대상입니다.
트랜잭션을 사용하지 않는 한 다중 섹터 쓰기가 원자성으로 보장되지 않습니다(즉, 생성된 핸들은 트랜잭션 핸들임). 단일 섹터 쓰기는 원자성입니다. 캐시된 다중 섹터 쓰기는 항상 디스크에 기록되지 않을 수 있습니다. 따라서 FILE_FLAG_WRITE_THROUGH 지정하여 전체 다중 섹터 쓰기가 캐싱 없이 디스크에 기록되도록 합니다.

앞에서 설명한 대로 lpSecurityAttributes 매개 변수가 NULL인 경우 CreateFileTransacted 에서 반환된 핸들은 애플리케이션이 만들 수 있는 자식 프로세스에서 상속할 수 없습니다. 이 매개 변수에 대한 다음 정보도 적용됩니다.

  • bInheritHandle이 0이 아닌 값인 FALSE가 아니면 핸들을 상속할 수 있습니다. 따라서 핸들을 상속할 수 없으면 이 구조체 멤버를 FALSE 로 올바르게 초기화해야 합니다.
  • 파일 또는 디렉터리에 대한 기본 보안 설명자의 ACL(액세스 제어 목록)은 부모 디렉터리에서 상속됩니다.
  • 대상 파일 시스템은 lpSecurityDescriptor가 영향을 주도록 파일 및 디렉터리에 대한 보안을 지원해야 하며 GetVolumeInformation을 사용하여 확인할 수 있습니다.
Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.
기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 No
SMB 3.0 TFO(투명 장애 조치(failover)) No
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 No
CsvFS(클러스터 공유 볼륨 파일 시스템) No
ReFS(Resilient File System) No
 

SMB 3.0은 TxF를 지원하지 않습니다.

파일

플로피 디스크 또는 CD가 없는 CD-ROM 드라이브가 없는 플로피 드라이브에 파일을 만들려고 하면 시스템에서 사용자가 디스크 또는 CD를 삽입하라는 메시지를 표시합니다. 시스템에서 이 메시지를 표시하지 않도록 하려면 SEM_FAILCRITICALERRORS사용하여 SetErrorMode 함수를 호출합니다.

자세한 내용은 파일 만들기 및 열기를 참조하세요.

파일 이름을 바꾸거나 삭제한 다음 잠시 후에 복원하는 경우 시스템은 복원할 파일 정보를 캐시에 검색합니다. 캐시된 정보에는 짧은/긴 이름 쌍 및 생성 시간이 포함됩니다.

DeleteFile에 대한 이전 호출의 결과로 삭제 보류 중인 파일에서 CreateFileTransacted를 호출하면 함수가 실패합니다. 운영 체제는 파일에 대한 모든 핸들을 닫을 때까지 파일 삭제를 지연합니다. GetLastError는ERROR_ACCESS_DENIED 반환합니다.

dwDesiredAccess 매개 변수는 0일 수 있으므로 애플리케이션이 적절한 보안 설정으로 실행 중인 경우 파일에 액세스하지 않고 파일 특성을 쿼리할 수 있습니다. 읽기 및/또는 쓰기 액세스를 위해 파일을 열지 않고 파일이 있는지 테스트하거나 파일 또는 디렉터리에 대한 다른 통계를 가져오는 데 유용합니다. 파일 정보 가져오기 및 설정GetFileInformationByHandle을 참조하세요.

애플리케이션이 네트워크를 통해 파일을 만드는 경우 GENERIC_WRITE 단독으로 사용하는 것보다 GENERIC_READ | GENERIC_WRITE 사용하는 것이 좋습니다. 리다이렉터에서 캐시 관리자를 사용하고 더 많은 데이터로 더 적은 SMB를 보낼 수 있으므로 결과 코드가 더 빠릅니다. 또한 이 조합은 네트워크를 통해 파일에 쓰는 경우 때때로 ERROR_ACCESS_DENIED 반환할 수 있는 문제를 방지합니다.

파일 스트림

NTFS 파일 시스템에서 CreateFileTransacted 를 사용하여 파일 내에 별도의 스트림을 만들 수 있습니다.

자세한 내용은 파일 스트림을 참조하세요.

디렉터리

애플리케이션은 CreateFileTransacted를 사용하여 디렉터리를 만들 수 없으므로 이 사용 사례의 경우 dwCreationDisposition대해 OPEN_EXISTING 값만 유효합니다. 디렉터리를 만들려면 애플리케이션에서 CreateDirectoryTransacted, CreateDirectory 또는 CreateDirectoryEx를 호출해야 합니다.

CreateFileTransacted를 사용하여 디렉터리를 열려면 dwFlagsAndAttributes의 일부로 FILE_FLAG_BACKUP_SEMANTICS 플래그를 지정합니다. 이 플래그를 SE_BACKUP_NAME 및 SE_RESTORE_NAME 권한 없이 사용하는 경우에도 적절한 보안 검사가 계속 적용됩니다.

CREATEFileTransacted를 사용하여 FAT 또는 FAT32 파일 시스템 볼륨을 조각 모음하는 동안 디렉터리를 여는 경우 MAXIMUM_ALLOWED 액세스 권한을 지정하지 마세요. 이 작업을 수행하면 디렉터리에 대한 액세스가 거부됩니다. 대신 GENERIC_READ 액세스를 지정합니다.

자세한 내용은 디렉터리 관리 정보를 참조하세요.

참고

winbase.h 헤더는 CREATEFileTransacted를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winbase.h(Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

CloseHandle

CopyFileTransacted

CreateDirectoryTransacted

DeleteFileTransacted

파일 압축 및 압축 해제

파일 암호화

파일 관리 함수

파일 보안 및 액세스 권한

파일 스트림

FindFirstFileTransacted

함수

GetFileAttributesTransacted

MoveFileTransacted

개요 항목

트랜잭션 NTFS에 대한 프로그래밍 고려 사항

ReadFile

트랜잭션 NTFS(TxF)

WriteFile