FindFirstChangeNotificationA 함수(fileapi.h)

  • 아티클

변경 알림 핸들을 만들고 초기 변경 알림 필터 조건을 설정합니다. 지정된 디렉터리 또는 하위 트리에서 필터 조건과 일치하는 변경 내용이 발생하면 알림 핸들에 대한 대기가 성공합니다. 함수는 지정된 디렉터리 자체에 변경 내용을 보고하지 않습니다.

이 함수는 대기 조건을 충족하는 변경 사항을 나타내지 않습니다. 알림의 일부로 특정 변경 내용에 대한 정보를 검색하려면 다음을 사용합니다.
ReadDirectoryChangesW 함수입니다.

구문

HANDLE FindFirstChangeNotificationA(
  [in] LPCSTR lpPathName,
  [in] BOOL   bWatchSubtree,
  [in] DWORD  dwNotifyFilter
);

매개 변수

[in] lpPathName

볼 디렉터리의 전체 경로입니다.

상대 경로 또는 빈 문자열일 수 없습니다.

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

팁

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

[in] bWatchSubtree

이 매개 변수가 TRUE이면 함수는 지정된 디렉터리에 루팅된 디렉터리 트리를 모니터링합니다. FALSE이면 지정된 디렉터리만 모니터링합니다.

[in] dwNotifyFilter

변경 알림 대기를 충족하는 필터 조건입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값 의미
FILE_NOTIFY_CHANGE_FILE_NAME
0x00000001
 확인된 디렉터리 또는 하위 트리에서 파일 이름을 변경하면 변경 알림이 반환할 작업을 기다리게 됩니다. 변경에는 이름 바꾸기, 파일 이름 만들기 또는 삭제가 포함됩니다.
FILE_NOTIFY_CHANGE_DIR_NAME
0x00000002
 감시된 디렉터리 또는 하위 트리의 디렉터리 이름 변경으로 인해 변경 알림 대기 작업이 반환됩니다. 변경 내용에는 디렉터리 만들기 또는 삭제가 포함됩니다.
FILE_NOTIFY_CHANGE_ATTRIBUTES
0x00000004
 확인된 디렉터리 또는 하위 트리에서 속성을 변경하면 변경 알림이 반환할 작업을 기다리게 됩니다.
FILE_NOTIFY_CHANGE_SIZE
0x00000008
 확인된 디렉터리 또는 하위 트리에서 파일 크기를 변경하면 변경 알림이 반환할 작업을 기다리게 됩니다. 운영 체제는 파일이 디스크에 기록될 때만 파일 크기에서 변경을 감지합니다. 광범위한 캐싱을 사용하는 운영 체제의 경우에는 캐시가 충분히 플러시될 때만 감지가 발생합니다.
FILE_NOTIFY_CHANGE_LAST_WRITE
0x00000010
 확인된 디렉터리 또는 하위 트리에서 파일의 마지막 기록 시간을 변경하면 변경 알림이 반환할 작업을 기다리게 됩니다. 운영 체제는 파일이 디스크에 기록될 때만 마지막 기록 시간에 대한 변경을 감지합니다. 광범위한 캐싱을 사용하는 운영 체제의 경우에는 캐시가 충분히 플러시될 때만 감지가 발생합니다.
FILE_NOTIFY_CHANGE_SECURITY
0x00000100
 감시된 디렉터리 또는 하위 트리의 보안 설명자 변경으로 인해 변경 알림 대기 작업이 반환됩니다.

반환 값

함수가 성공하면 반환 값은 찾기 변경 알림 개체에 대한 핸들입니다.

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

설명

대기 함수는FindFirstChangeNotification 함수에서 반환된 핸들을 사용하여 지정된 디렉터리 또는 하위 트리를 모니터링할 수 있습니다. 모니터링되는 디렉터리 또는 하위 트리에서 필터 조건 중 하나가 발생하면 대기가 충족됩니다.

대기가 충족되면 애플리케이션이 이 조건에 응답하고 FindNextChangeNotification 함수 및 적절한 대기 함수를 호출하여 디렉터리를 계속 모니터링할 수 있습니다. 핸들이 더 이상 필요하지 않은 경우 FindCloseChangeNotification 함수를 사용하여 핸들을 닫을 수 있습니다.

원격 파일 시스템에 대해 FindFirstChangeNotification 을 호출할 때 알림이 반환되지 않을 수 있습니다.

바로 가기 링크 동작 - 경로가 기호 링크를 가리키는 경우 대상에 대한 알림 핸들이 만들어집니다.

애플리케이션이 바로 가기 링크를 포함하는 디렉터리에 대한 변경 알림을 받도록 등록한 경우 대상 파일이 아니라 바로 가기 링크가 변경된 경우에만 애플리케이션에 알림이 표시됩니다.

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

기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 Yes
SMB 3.0 TFO(투명 장애 조치(failover)) Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 Yes
CsvFS(클러스터 공유 볼륨 파일 시스템) 설명 보기
ReFS(Resilient File System) Yes
 

애플리케이션에서 CsvF 일시 중지/다시 시작 시 가양성 발생이 발생할 수 있습니다.

예제

예제는 디렉터리 Change_Notifications 가져오기를 참조하세요.

참고

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

요구 사항

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

참고 항목

디렉터리 관리 함수

FindCloseChangeNotification

FindNextChangeNotification

ReadDirectoryChangesW