SetSecurityDescriptorOwner 함수(securitybaseapi.h)

아티클
08/25/2023

SetSecurityDescriptorOwner 함수는 절대 형식 보안 설명자의 소유자 정보를 설정합니다. 보안 설명자에 이미 있는 소유자 정보를 대체합니다.

구문

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

매개 변수

[in, out] pSecurityDescriptor

소유자가 이 함수에 의해 설정된 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 함수는 기존 소유자를 새 소유자로 바꿉니다.

[in, optional] pOwner

보안 설명자의 새 주 소유자에 대한 SID 구조에 대한 포인터입니다. SID 구조는 보안 설명자에 복사되지 않고 에서 참조됩니다. 이 매개 변수가 NULL이면 함수는 보안 설명자의 소유자 정보를 지웁니다. 이렇게 하면 보안 설명자가 소유자가 없는 것으로 표시됩니다.

[in] bOwnerDefaulted

소유자 정보가 기본 메커니즘에서 파생되었는지 여부를 나타냅니다. 이 값이 TRUE이면 기본 정보입니다. 함수는 이 값을 SECURITY_DESCRIPTOR_CONTROL 구조체 의 SE_OWNER_DEFAULTED 플래그로 저장합니다. 이 매개 변수가 0이면 SE_OWNER_DEFAULTED 플래그가 지워집니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

요구 사항


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