RegDeleteKey(A)

RegDeleteKey(A)

레지스트리의 서브 키를 삭제합니다.

Windows 95/98/Me： 지정된 키가 가지는 모든 서브 키와 값도 포함해 삭제합니다.키가 서브 키나 값을 가지지 않는 경우에게만 키를 삭제하려면 , SHDeleteEmptyKey 함수를 사용합니다.

Windows NT/2000/XP： 삭제하는 키가 서브 키를 가지고 있어서는 안됩니다.키를 삭제하려면 , 그 키가 가지는 서브 키를 먼저 삭제할 필요가 있습니다.키가 가지는 모든 서브 키와 값도 포함해 삭제하려면 , SHDeleteKey 함수를 사용합니다.

LONG RegDeleteKeyA(
    HKEY    hKey,       // 키의 핸들
    PCTSTR  pszSubKey   // 삭제하는 키의 이름
);

ADVAPI32.DLL

인수

hKey

현재 오픈하고 있는 키의 핸들을 지정합니다.이 핸들은 DELETE 액세스를 가지고 있지 않으면 안됩니다.

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

치	정의가 끝난 키
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

pszSubKey 파라미터로 지정되는 키는, 이 파라미터 지정되는 키의 서브 키가 아니면 안됩니다.

lpSubKey

삭제하는 서브 키의 이름을 나타내는 문자열의 주소를 지정합니다. 0 (NULL) (을)를 지정할 수 없습니다.

Windows NT/2000/XP： 지정되는 키는 서브 키를 가지고 있어서는 안됩니다.

반환값

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

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

대응 정보

Windows 95 이후 / Windows NT 3.1 이후