RegSetKeySecurity 함수(winreg.h)

아티클
03/08/2023

RegSetKeySecurity 함수는 열린 레지스트리 키의 보안을 설정합니다.

구문

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

매개 변수

[in] hKey

보안 설명자가 설정된 열린 키에 대한 핸들입니다.

[in] SecurityInformation

설정할 보안 정보의 유형을 나타내는 비트 플래그 집합입니다. 이 매개 변수는 SECURITY_INFORMATION 비트 플래그의 조합일 수 있습니다.

[in] pSecurityDescriptor

지정된 키에 대해 설정할 보안 특성을 지정하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 ERROR_SUCCESS 반환합니다.

함수가 실패하면 WinError.h에 정의된 0이 아닌 오류 코드를 반환합니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.

설명

hKey가 미리 정의된 키 중 하나인 경우 RegCloseKey 함수를 사용하여 미리 정의된 키를 닫아 다음에 미리 정의된 키를 참조할 때 새 보안 정보가 적용되는지 확인합니다.

요구 사항

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