RegFlushKey 함수(winreg.h)
지정된 열린 레지스트리 키의 특성을 모두 레지스트리에 기록합니다.
구문
LSTATUS RegFlushKey(
[in] HKEY hKey
);
매개 변수
[in] hKey
열린 레지스트리 키에 대한 핸들입니다. 키는 KEY_QUERY_VALUE 액세스 권한으로 열려 있어야 합니다. 자세한 내용은 레지스트리 키 보안 및 액세스 권한을 참조하세요.
이 핸들은 RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx 또는 RegOpenKeyTransacted 함수에서 반환됩니다. 다음 미리 정의된 키 중 하나일 수도 있습니다.
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_PERFORMANCE_DATA
- HKEY_USERS
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.
설명
RegFlushKey 호출은 디스크 대역폭을 사용하고 플러시 작업이 완료될 때까지 플러시되는 레지스트리 하이브의 모든 프로세스에서 모든 키에 대한 수정을 차단하기 때문에 시스템 전체 성능에 크게 영향을 주는 비용이 많이 드는 작업입니다. RegFlushKey 는 애플리케이션이 수정 후 즉시 레지스트리 변경 내용이 디스크에 유지되도록 보장해야 하는 경우에만 명시적으로 호출해야 합니다. 키에 대한 모든 수정 사항은 디스크에 플러시할 필요 없이 다른 프로세스에 표시됩니다.
또는 레지스트리에는 정기적으로 디스크에 대한 레지스트리 수정 사항을 플러시하는 '지연 플러시' 메커니즘이 있습니다. 이 정기적인 플러시 작업 외에도 시스템 종료 시 레지스트리 변경 내용이 디스크에 플러시됩니다. '지연 플러시'가 레지스트리 변경 내용을 플러시하도록 허용하는 것이 디스크의 레지스트리 저장소에 대한 레지스트리 쓰기를 관리하는 가장 효율적인 방법입니다.
RegFlushKey 함수는 지정된 키를 포함하는 Hive의 모든 데이터가 디스크의 레지스트리 저장소에 기록된 경우에만 를 반환합니다.
RegFlushKey 함수는 마지막 지연 플러시 또는 시스템 시작 이후 수정된 하이브의 다른 키에 대한 데이터를 씁니다.
RegFlushKey가 반환되면 RegCloseKey를 사용하여 레지스트리 키에 대한 핸들을 닫습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winreg.h(Windows.h 포함) |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |