FILE_RENAME_INFO 구조체(winbase.h)

원본 파일의 이름을 바꿀 대상 이름을 포함합니다. SetFileInformationByHandle을 호출할 때만 사용합니다.

구문

typedef struct _FILE_RENAME_INFO {
  union {
    BOOLEAN ReplaceIfExists;
    DWORD   Flags;
  } DUMMYUNIONNAME;
  BOOLEAN ReplaceIfExists;
  HANDLE  RootDirectory;
  DWORD   FileNameLength;
  WCHAR   FileName[1];
} FILE_RENAME_INFO, *PFILE_RENAME_INFO;

멤버

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

이 필드는 SetFileInformationByHandle의 FileInformationClass 매개 변수가 FileRenameInfo로 설정된 경우에 사용됩니다. 이 필드가 TRUE 이고 대상 파일이 있는 경우 대상 파일이 원본 파일로 대체됩니다. 이 필드가 FALSE 이고 대상 파일이 있는 경우 작업은 오류를 반환합니다.

DUMMYUNIONNAME.Flags

이 필드는 SetFileInformationByHandle의 FileInformationClass 매개 변수가 FileRenameInfoEx로 설정된 경우에 사용됩니다.

ReplaceIfExists

RootDirectory

이 필드는 NULL로 설정해야 합니다.

FileNameLength

NUL 종료를 포함하지 않는 FileName 크기(바이트)입니다.

FileName[1]

파일에 대한 새 경로를 포함하는 NUL로 종료된 와이드 문자열입니다. 값은 다음 중 하나일 수 있습니다.

• 절대 경로(드라이브, 디렉터리 및 파일 이름)입니다.
• 프로세스의 현재 디렉터리를 기준으로 하는 경로입니다.
• 부터 NTFS 파일 스트림의 새 이름입니다 :.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	winbase.h(Windows.h 포함)
재배포 가능 파일	Windows Server 2003 및 Windows XP에서 Windows SDK.

추가 정보

FILE_INFO_BY_HANDLE_CLASS

SetFileInformationByHandle