IADsSecurityUtility

IADsSecurityUtility インターフェイスは、ファイル、ファイル共有、またはレジストリキーのセキュリティ記述子を取得または設定するために使用します。

ファイルまたはディレクトリのシステムアクセス制御リスト (SACL) を読み取るには、呼び出し元プロセスで SE_SECURITY_NAME 特権が有効になっている必要があります。オブジェクトの SACL を取得する方法の詳細については、Retrieving an Object's SACL を参照してください。

IADsSecurityUtility インターフェイスを使用してファイルに ACE を追加する方法の詳細とコード例については、Example Code for Adding an ACE to a File を参照してください。

指定したファイル、ファイル共有、またはレジストリキーのセキュリティ記述子を取得します。

成功した場合は S_OK を、それ以外の場合は COM または Win32 のエラーコードを返します。返される可能性のあるエラーコードには次のものがあります。

指定したファイル、ファイル共有、またはレジストリキーのセキュリティ記述子を設定します。

成功した場合は S_OK を、それ以外の場合は COM または Win32 のエラーコードを返します。返される可能性のあるエラーコードを次の一覧に示します。

アクセス制御エントリは、セキュリティ記述子のアクセス制御リスト内で次の順序で並んでいる必要があります。

• オブジェクト自体に適用されるアクセス拒否 ACE
• プロパティセットやプロパティなど、オブジェクトの子に適用されるアクセス拒否 ACE
• オブジェクト自体に適用されるアクセス許可 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
 
' Jeff Smith 用の新しい ACE を追加します。 
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("エラーが発生しました。 " & Err.Number)
    End If
    Set dacl = Nothing
    Set sd = Nothing
    Set newAce = Nothing
    Set sdUtil = Nothing

セキュリティ記述子をある形式から別の形式に変換します。

成功した場合は S_OK を、それ以外の場合は COM または Win32 のエラーコードを返します。返される可能性のあるエラーコードには次のものがあります。

セキュリティ記述子のどの要素を取得または設定するかを決定します。(Get)

呼び出しの成功または失敗を示す HRESULT 値。

セキュリティ記述子のどの要素を取得または設定するかを決定します。(Put)

呼び出しの成功または失敗を示す HRESULT 値。