RegFlushKey

RegFlushKey

레지스트리 키의 변경을 실제로 레지스트리에 플래시(기입) 합니다.

LONG RegFlushKey(
    HKEY hKey    // 키의 핸들
);

ADVAPI32.DLL

인수

hKey

현재 오픈되고 있는 키의 핸들을 지정합니다.

다음의 정의가 끝난 키를 지정할 수도 있습니다.

치	정의가 끝난 키
0x80000000	HKEY_CLASSES_ROOT
0x80000001	HKEY_CURRENT_USER
0x80000002	HKEY_LOCAL_MACHINE
0x80000003	HKEY_USERS
0x80000004	Windows NT/2000/XP： HKEY_PERFORMANCE_DATA
0x80000005	HKEY_CURRENT_CONFIG
0x80000006	Windows 95/98/Me： HKEY_DYN_DATA

반환값

성공하면 0 (ERROR_SUCCESS) 하지만 돌아갑니다.

실패하면 0 이외의 에러 코드가 돌아갑니다.이 에러 코드와 FORMAT_MESSAGE_FROM_SYSTEM 플래그를 지정해 FormatMessage 함수를 호출하는 것으로, 에러 메세지를 취득할 수 있습니다.

해설

레지스트리 키의 변경은 지연적으로(통상은 몇 초 이내에) 플래시 되므로, 키를 변경했다고 RegFlushKey 함수를 호출할 필요는 없습니다.일반적으로는, 이 함수는 거의 사용될 것은 없습니다.레지스트리에의 기입을 확실히 완료시키고 싶은 경우에게만 사용하도록 해 주세요.

이 함수는, 지정된 키 이외의 키에 대해서도 데이터를 플래시 시키는 일이 있습니다.이 함수를 필요이상으로 호출하면, 어플리케이션의 퍼포먼스에 악영향을 미칠 가능성이 있습니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후