IADsSecurityUtility::SetSecurityDescriptor 메서드(iads.h)

아티클
08/24/2023

SetSecurityDescriptor 메서드는 지정된 파일, 파일 공유 또는 레지스트리 키에 대한 보안 설명자를 설정합니다.

구문

HRESULT SetSecurityDescriptor(
  [in] VARIANT varPath,
  [in] long    lPathFormat,
  [in] VARIANT varData,
  [in] long    lDataFormat
);

매개 변수

[in] varPath

보안 설명자를 설정할 개체의 경로를 포함하는 VARIANT 문자열입니다. 가능한 값은 다음 목록에 나열됩니다.

파일

유효한 파일 경로 구문입니다. 예: "c:\specs\public\adxml.doc" 또는 "\adsi\public\dsclient.exe".

파일 공유에 대한 유효한 파일 경로 구문입니다. 예: "\adsi\public".

레지스트리 키

유효한 레지스트리 구문입니다. 예를 들어 "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs"입니다.

[in] lPathFormat

varPath 매개 변수의 형식을 지정하는 ADS_PATHTYPE_ENUM 값 중 하나를 포함합니다.

[in] varData

새 보안 설명자를 포함하는 VARIANT 입니다. 보안 설명자의 형식은 lDataFormat 매개 변수에 의해 지정됩니다.

[in] lDataFormat

VarData 매개 변수에 포함된 보안 설명자의 형식을 지정하는 ADS_SD_FORMAT_ENUM 값 중 하나를 포함합니다. 다음 목록에서는 이 매개 변수의 가능한 값과 VarData 매개 변수의 형식을 식별합니다.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 COM 또는 Win32 오류 코드를 반환합니다. 가능한 오류 코드는 다음 목록에 나열됩니다.

설명

액세스 제어 항목은 보안 설명자의 액세스 제어 목록에 다음 순서로 표시되어야 합니다.

개체 자체에 적용되는 액세스 거부 ACL
속성 집합 또는 속성과 같이 개체의 자식에 적용되는 액세스 거부 ACL
개체 자체에 적용되는 액세스 허용 ACE
속성 집합 또는 속성과 같은 개체의 자식에 적용되는 액세스 허용 ACE
상속된 모든 ACE

예제

다음 코드 예제에서는 파일에 대 한 보안 설명자를 설정 하는 방법을 보여 입니다.

Dim dacl as IADsAccessControlList
Dim sd as IADsSecurityDescriptor
Dim newAce as New AccessControlEntry
Dim sdUtil as New ADsSecurityUtility

Set sd = sdUtil.GetSecurityDescriptor("c:\specs\adsixml.doc", ADS_PATH_FILE, ADS_SD_FORMAT_IID )
Set dacl = sd.DiscretionaryAcl
 
' Add a new ACE for Jeff Smith. 
newAce.Trustee = "Fabrikam\jeffsmith" 
newAce.AccessMask = ADS_RIGHT_GENERIC_READ Or ADS_RIGHT_GENERIC_EXECUTE 

newAce.AceType = ADS_ACETYPE_ACCESS_ALLOWED 

dacl.AddAce newAce 
sd.DiscretionaryAcl = dacl 
sdUtil.SetSecurityDescriptor "c:\specs\adsixml.doc", ADS_PATH_FILE, sd, ADS_SD_FORMAT_IID

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set dacl = Nothing
    Set sd = Nothing
    Set newAce = Nothing
    Set sdUtil = Nothing

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	iads.h
DLL	Activeds.dll