ホーム › Security › SetSecurityDescriptorDacl

SetSecurityDescriptorDacl

関数

セキュリティ記述子にDACL(任意アクセス制御リスト)を設定する。

DLLADVAPI32.dll呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// ADVAPI32.dll
#include <windows.h>

BOOL SetSecurityDescriptorDacl(
    PSECURITY_DESCRIPTOR pSecurityDescriptor,
    BOOL bDaclPresent,
    ACL* pDacl,   // optional
    BOOL bDaclDefaulted
);

パラメーター

名前	型	方向	説明
pSecurityDescriptor	PSECURITY_DESCRIPTOR	inout	関数が DACL を追加する対象の SECURITY_DESCRIPTOR 構造体へのポインターです。このセキュリティ記述子は絶対 (absolute) 形式である必要があります。つまり、そのメンバーは連続したデータへのオフセットではなく、他の構造体へのポインターである必要があります。
bDaclPresent	BOOL	in	セキュリティ記述子に DACL が存在することを示すフラグです。このパラメーターが TRUE の場合、関数は SECURITY_DESCRIPTOR_CONTROL 構造体の SE_DACL_PRESENT フラグを設定し、pDacl および bDaclDefaulted パラメーターの値を使用します。このパラメーターが FALSE の場合、関数は SE_DACL_PRESENT フラグをクリアし、pDacl および bDaclDefaulted は無視されます。
pDacl	ACL*	inoptional	セキュリティ記述子の DACL を指定する ACL 構造体へのポインターです。このパラメーターが NULL の場合、セキュリティ記述子には NULL DACL が割り当てられ、オブジェクトへのすべてのアクセスが許可されます。DACL はセキュリティ記述子にコピーされるのではなく、参照されます。
bDaclDefaulted	BOOL	in	DACL の取得元を示すフラグです。このフラグが TRUE の場合、DACL は何らかの既定のメカニズムによって取得されたものです。FALSE の場合、DACL はユーザーによって明示的に指定されたものです。関数はこの値を SECURITY_DESCRIPTOR_CONTROL 構造体の SE_DACL_DEFAULTED フラグに格納します。このパラメーターが指定されない場合、SE_DACL_DEFAULTED フラグはクリアされます。

戻り値の型: BOOL

公式ドキュメント

任意アクセス制御リスト (DACL) に情報を設定します。セキュリティ記述子に既に DACL が存在する場合、その DACL は置き換えられます。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗した場合、0 を返します。拡張エラー情報を取得するには、 GetLastError を呼び出します。

解説(Remarks)

空の DACL と存在しない DACL の間には重要な違いがあります。DACL が空の場合、アクセス制御エントリ (ACE) を含まないため、アクセス権が明示的に付与されません。その結果、オブジェクトへのアクセスは暗黙的に拒否されます。

オブジェクトに DACL がない場合 (pDacl パラメーターが NULL の場合)、オブジェクトには保護が割り当てられず、すべてのアクセス要求が許可されます。セキュリティを維持するために、DACL を使用してアクセスを制限してください。

bDaclPresent フラグと pDacl パラメーターの構成の違いにより、3 つの結果が考えられます。

pDacl パラメーターが DACL を指し、bDaclPresent フラグが TRUE の場合、DACL が指定されます。オブジェクトへのアクセスを許可するには、その DACL にアクセス許可 ACE が含まれている必要があります。
pDacl パラメーターが DACL を指さず、bDaclPresent フラグが TRUE の場合、NULL DACL が指定されます。すべてのアクセスが許可されます。どのユーザーもセキュリティ記述子の DACL と所有者を変更できるため、オブジェクトに NULL DACL を使用しないでください。これはオブジェクトの使用に支障をきたします。
pDacl パラメーターが DACL を指さず、bDaclPresent フラグが FALSE の場合、継承または既定のメカニズムを通じてオブジェクトに DACL を提供できます。

例

この関数を使用する例については、新しいオブジェクトのセキュリティ記述子の作成を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// ADVAPI32.dll
#include <windows.h>

BOOL SetSecurityDescriptorDacl(
    PSECURITY_DESCRIPTOR pSecurityDescriptor,
    BOOL bDaclPresent,
    ACL* pDacl,   // optional
    BOOL bDaclDefaulted
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool SetSecurityDescriptorDacl(
    IntPtr pSecurityDescriptor,   // PSECURITY_DESCRIPTOR in/out
    bool bDaclPresent,   // BOOL
    IntPtr pDacl,   // ACL* optional
    bool bDaclDefaulted   // BOOL
);

<DllImport("ADVAPI32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function SetSecurityDescriptorDacl(
    pSecurityDescriptor As IntPtr,   ' PSECURITY_DESCRIPTOR in/out
    bDaclPresent As Boolean,   ' BOOL
    pDacl As IntPtr,   ' ACL* optional
    bDaclDefaulted As Boolean   ' BOOL
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' pSecurityDescriptor : PSECURITY_DESCRIPTOR in/out
' bDaclPresent : BOOL
' pDacl : ACL* optional
' bDaclDefaulted : BOOL
Declare PtrSafe Function SetSecurityDescriptorDacl Lib "advapi32" ( _
    ByVal pSecurityDescriptor As LongPtr, _
    ByVal bDaclPresent As Long, _
    ByVal pDacl As LongPtr, _
    ByVal bDaclDefaulted As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

SetSecurityDescriptorDacl = ctypes.windll.advapi32.SetSecurityDescriptorDacl
SetSecurityDescriptorDacl.restype = wintypes.BOOL
SetSecurityDescriptorDacl.argtypes = [
    wintypes.HANDLE,  # pSecurityDescriptor : PSECURITY_DESCRIPTOR in/out
    wintypes.BOOL,  # bDaclPresent : BOOL
    ctypes.c_void_p,  # pDacl : ACL* optional
    wintypes.BOOL,  # bDaclDefaulted : BOOL
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
SetSecurityDescriptorDacl = Fiddle::Function.new(
  lib['SetSecurityDescriptorDacl'],
  [
    Fiddle::TYPE_VOIDP,  # pSecurityDescriptor : PSECURITY_DESCRIPTOR in/out
    Fiddle::TYPE_INT,  # bDaclPresent : BOOL
    Fiddle::TYPE_VOIDP,  # pDacl : ACL* optional
    Fiddle::TYPE_INT,  # bDaclDefaulted : BOOL
  ],
  Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn SetSecurityDescriptorDacl(
        pSecurityDescriptor: *mut core::ffi::c_void,  // PSECURITY_DESCRIPTOR in/out
        bDaclPresent: i32,  // BOOL
        pDacl: *mut ACL,  // ACL* optional
        bDaclDefaulted: i32  // BOOL
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", SetLastError = true)]
public static extern bool SetSecurityDescriptorDacl(IntPtr pSecurityDescriptor, bool bDaclPresent, IntPtr pDacl, bool bDaclDefaulted);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_SetSecurityDescriptorDacl' -Namespace Win32 -PassThru
# $api::SetSecurityDescriptorDacl(pSecurityDescriptor, bDaclPresent, pDacl, bDaclDefaulted)

#uselib "ADVAPI32.dll"
#func global SetSecurityDescriptorDacl "SetSecurityDescriptorDacl" sptr, sptr, sptr, sptr
; SetSecurityDescriptorDacl pSecurityDescriptor, bDaclPresent, varptr(pDacl), bDaclDefaulted   ; 戻り値は stat
; pSecurityDescriptor : PSECURITY_DESCRIPTOR in/out -> "sptr"
; bDaclPresent : BOOL -> "sptr"
; pDacl : ACL* optional -> "sptr"
; bDaclDefaulted : BOOL -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ADVAPI32.dll"
#cfunc global SetSecurityDescriptorDacl "SetSecurityDescriptorDacl" sptr, int, var, int
; res = SetSecurityDescriptorDacl(pSecurityDescriptor, bDaclPresent, pDacl, bDaclDefaulted)
; pSecurityDescriptor : PSECURITY_DESCRIPTOR in/out -> "sptr"
; bDaclPresent : BOOL -> "int"
; pDacl : ACL* optional -> "var"
; bDaclDefaulted : BOOL -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll"
#cfunc global SetSecurityDescriptorDacl "SetSecurityDescriptorDacl" sptr, int, sptr, int
; res = SetSecurityDescriptorDacl(pSecurityDescriptor, bDaclPresent, varptr(pDacl), bDaclDefaulted)
; pSecurityDescriptor : PSECURITY_DESCRIPTOR in/out -> "sptr"
; bDaclPresent : BOOL -> "int"
; pDacl : ACL* optional -> "sptr"
; bDaclDefaulted : BOOL -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。