Win32_DCOMApplicationSetting 클래스의 SetAccessSecurityDescriptor 메서드

  • 아티클

SetAccessSecurityDescriptor 메서드는 DCOM 애플리케이션의 액세스 보안 설명자를 Win32_SecurityDescriptor 클래스의 instance 정의된 새 보안 설명자로 업데이트합니다. 이 보안 설명자는 애플리케이션에 액세스할 수 있는 사용자를 제어합니다. 이 메서드를 호출하는 스크립트 또는 애플리케이션을 실행하는 계정에는 SeSecurityPrivilege 및 SeRestorePrivilege 권한이 있어야 합니다. 자세한 내용은 보안 개체에 대한 액세스 보안 변경을 참조하세요.

구문

uint32 SetAccessSecurityDescriptor(
  [in] Win32_SecurityDescriptor Descriptor
);

매개 변수

설명자[in]

DCOM 애플리케이션에 대해 설정할 보안 설명자입니다.

반환 값

다음 목록에 나열된 값 중 하나를 반환하거나 오류를 나타내는 다른 값을 반환합니다. 자세한 내용은 WMI 반환 코드 또는 WbemErrorEnum을 참조하세요.

Success

0

완료되었습니다.

2

사용자에게 요청된 정보에 대한 액세스 권한이 없습니다.

8

알 수 없는 오류

9

사용자에게 메서드를 실행할 수 있는 적절한 권한이 없습니다.

21

메서드 호출에 지정된 매개 변수가 잘못되었습니다.

기타

1 4294967295

설명

Win32_SecurityDescriptor 인스턴스는 SECURITY_DESCRIPTOR_CONTROL 데이터 형식을 나타내며 DACL(임의 액세스 제어 목록) 및 SACL(시스템 액세스 제어 목록)을 포함합니다. 자세한 내용은 액세스 제어 목록을 참조하십시오.

보안 설명자를 받을 때 SeSecurityPrivilege가 부여되거나 활성화되지 않은 경우 반환된 보안 설명자에 DACL만 반환됩니다. 자세한 내용은 권한 상수 및 권한 있는 작업 실행을 참조하세요.

이 메서드를 호출할 때 Win32_SecurityDescriptor 인스턴스에서 DACL과 SACL을 모두 업데이트할 수 있지만 DACL 또는 SACL만 업데이트할 수도 있습니다.

SECURITY_DESCRIPTOR_CONTROL 다음 값은 DACL, SACL 또는 둘 다 업데이트되는지 여부를 결정합니다.

  • SE_DACL_PRESENT

    DACL을 업데이트해야 함을 나타냅니다. 이 값이 설정되지 않은 경우 WMI는 DACL의 원래 값을 유지합니다.

  • SE_SACL_PRESENT

    SACL을 업데이트함을 나타냅니다. 이 값이 설정되지 않은 경우 WMI는 SACL의 원래 값을 유지합니다. SACL을 업데이트하려면 계정에 SeSecurityPrivilege 권한이 활성화되어 있어야 합니다. 스크립팅의 경우, 권한 이름은 SeSecurityPrivilege입니다. 자세한 내용은 권한 상수를 참조하세요.

그룹 트러스티와 소유자 트러스티 속성이 NULL이 아닌 경우 업데이트됩니다. 그렇지 않으면 WMI는 원래 값을 유지합니다. 자세한 내용은 WMI 보안 설명자 개체를 참조하세요.

이 메서드에 대한 호출에서 새 SACL이 NULL 이면 대상 보안 개체의 보안 설명자 SACL은 변경되지 않은 상태로 유지됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
네임스페이스
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

추가 정보

Win32_DCOMApplicationSetting

권한 상수

WMI 보안 설명자 개체

보안 개체에 대한 액세스 보안 변경