FindFirstFileNameTransactedW 함수(winbase.h)
[Microsoft는 개발자가 애플리케이션의 요구 사항을 달성하기 위해 대체 수단을 활용하는 것이 좋습니다. TxF가 개발된 많은 시나리오는 더 간단하고 쉽게 사용할 수 있는 기술을 통해 달성할 수 있습니다. 또한 이후 버전의 Microsoft Windows에서는 TxF를 사용하지 못할 수도 있습니다. TxF에 대한 자세한 내용과 대안은 트랜잭션 NTFS 사용에 대한 대안을 참조하세요.]
트랜잭션 작업으로 지정된 파일에 대한 모든 하드 링크의 열거형을 만듭니다. 이 함수는 후속 FindNextFileNameW 함수 호출에 사용할 수 있는 열거형에 대한 핸들을 반환합니다.
구문
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
매개 변수
[in] lpFileName
파일 이름입니다.
파일은 로컬 컴퓨터에 있어야 합니다. 그렇지 않으면 함수가 실패하고 마지막 오류 코드가 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805)로 설정됩니다.
[in] dwFlags
예약; 0을 지정합니다.
[in, out] StringLength
LinkName 매개 변수가 가리키는 버퍼의 크기(문자)입니다. 이 호출이 실패하고 오류가 ERROR_MORE_DATA (234)인 경우 이 매개 변수에서 반환되는 값은 LinkName 이 가리키는 버퍼가 모든 데이터를 포함해야 하는 크기입니다.
[in, out] LinkName
lpFileName에 대한 첫 번째 링크 이름을 저장할 버퍼에 대한 포인터입니다.
[in, optional] hTransaction
트랜잭션에 대한 핸들입니다. 이 핸들은 CreateTransaction 함수에 의해 반환됩니다.
반환 값
함수가 성공하면 반환 값은 FindNextFileNameW 함수와 함께 사용하거나 FindClose 함수로 닫을 수 있는 검색 핸들입니다.
함수가 실패하면 반환 값이 INVALID_HANDLE_VALUE (0xffffffff)됩니다. 대상
확장 오류 정보를 가져와 GetLastError 함수를 호출합니다.
설명
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를 지원하지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |