ホーム › Security.Authorization › SetSecurityInfo

SetSecurityInfo

関数

ハンドルで指定したオブジェクトのセキュリティ情報を設定する。

DLLADVAPI32.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

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

WIN32_ERROR SetSecurityInfo(
    HANDLE handle,
    SE_OBJECT_TYPE ObjectType,
    OBJECT_SECURITY_INFORMATION SecurityInfo,
    PSID psidOwner,   // optional
    PSID psidGroup,   // optional
    ACL* pDacl,   // optional
    ACL* pSacl   // optional
);

パラメーター

名前	型	方向	説明
handle	HANDLE	in	セキュリティ情報を設定する対象オブジェクトのハンドルです。
ObjectType	SE_OBJECT_TYPE	in	handle パラメーターで識別されるオブジェクトの種類を示す SE_OBJECT_TYPE 列挙体のメンバーです。
SecurityInfo	OBJECT_SECURITY_INFORMATION	in	設定するセキュリティ情報の種類を示すビットフラグのセットです。このパラメーターには SECURITY_INFORMATION ビットフラグの組み合わせを指定できます。
psidOwner	PSID	inoptional	オブジェクトの所有者を識別する SID へのポインターです。この SID は、セキュリティ記述子の所有者 SID として割り当て可能なものである必要があります。SecurityInfo パラメーターには OWNER_SECURITY_INFORMATION フラグを含める必要があります。所有者 SID を設定しない場合、このパラメーターは NULL にできます。
psidGroup	PSID	inoptional	オブジェクトのプライマリグループを識別する SID へのポインターです。SecurityInfo パラメーターには GROUP_SECURITY_INFORMATION フラグを含める必要があります。プライマリグループの SID を設定しない場合、このパラメーターは NULL にできます。
pDacl	ACL*	inoptional	オブジェクトの新しい DACL へのポインターです。このパラメーターは、SecurityInfo パラメーターの値に DACL_SECURITY_INFORMATION フラグが含まれていない限り無視されます。SecurityInfo パラメーターの値に DACL_SECURITY_INFORMATION フラグが含まれ、かつこのパラメーターの値が NULL に設定されている場合、すべてのユーザーにオブジェクトへのフルアクセスが付与されます。null DACL については、Creating a DACL を参照してください。
pSacl	ACL*	inoptional	オブジェクトの新しい SACL へのポインターです。SecurityInfo パラメーターには、SACL_SECURITY_INFORMATION、LABEL_SECURITY_INFORMATION、ATTRIBUTE_SECURITY_INFORMATION、SCOPE_SECURITY_INFORMATION、BACKUP_SECURITY_INFORMATION のいずれかのフラグを含める必要があります。SACL_SECURITY_INFORMATION または SCOPE_SECURITY_INFORMATION を設定する場合、呼び出し元は SE_SECURITY_NAME 特権を有効にしておく必要があります。SACL を設定しない場合、このパラメーターは NULL にできます。

戻り値の型: WIN32_ERROR

公式ドキュメント

指定したオブジェクトのセキュリティ記述子に、指定したセキュリティ情報を設定します。呼び出し元はハンドルによってオブジェクトを識別します。

戻り値

関数が成功した場合、ERROR_SUCCESS を返します。

関数が失敗した場合は、WinError.h で定義されている 0 以外のエラーコードを返します。

解説(Remarks)

オブジェクトの任意アクセス制御リスト (DACL) またはシステムアクセス制御リスト (SACL) の任意の要素を設定すると、システムは ACE 継承規則に従って、継承可能なアクセス制御エントリ (ACE) を既存の子オブジェクトへ自動的に伝播します。

SetSecurityInfo 関数は、次の種類のオブジェクトに対して使用できます。

NTFS 上のローカルまたはリモートのファイルおよびディレクトリ
名前付きパイプ
ローカルまたはリモートのプリンター
ローカルまたはリモートの Windows サービス
ネットワーク共有
レジストリキー
セマフォ、イベント、ミューテックス、および待機可能タイマー
プロセス、スレッド、ジョブ、およびファイルマッピングオブジェクト
ウィンドウステーションおよびデスクトップ
ディレクトリサービスオブジェクト

SetSecurityInfo 関数は、アクセス許可またはアクセス拒否の ACE を推奨される順序に基づいて並べ替えることはありません。継承可能な ACE を既存の子オブジェクトへ伝播する際、SetSecurityInfo は、子オブジェクトの DACL 内のすべての非継承 ACE の後ろに、継承された ACE を配置します。

Note オブジェクトの子に対する共有アクセスが利用できない場合、この関数は保護されていない ACE を子に伝播しません。たとえば、ディレクトリが排他アクセスで開かれている場合、そのディレクトリのセキュリティが変更されても、オペレーティングシステムはそのサブディレクトリやファイルに対して保護されていない ACE を伝播しません。

Warning 指定された handle が MAXIMUM_ALLOWED の ACCESS_MASK 値で開かれていた場合、SetSecurityInfo 関数は ACE を子に伝播しません。

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

各言語での呼び出し定義

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

WIN32_ERROR SetSecurityInfo(
    HANDLE handle,
    SE_OBJECT_TYPE ObjectType,
    OBJECT_SECURITY_INFORMATION SecurityInfo,
    PSID psidOwner,   // optional
    PSID psidGroup,   // optional
    ACL* pDacl,   // optional
    ACL* pSacl   // optional
);

[DllImport("ADVAPI32.dll", ExactSpelling = true)]
static extern uint SetSecurityInfo(
    IntPtr handle,   // HANDLE
    int ObjectType,   // SE_OBJECT_TYPE
    uint SecurityInfo,   // OBJECT_SECURITY_INFORMATION
    IntPtr psidOwner,   // PSID optional
    IntPtr psidGroup,   // PSID optional
    IntPtr pDacl,   // ACL* optional
    IntPtr pSacl   // ACL* optional
);

<DllImport("ADVAPI32.dll", ExactSpelling:=True)>
Public Shared Function SetSecurityInfo(
    handle As IntPtr,   ' HANDLE
    ObjectType As Integer,   ' SE_OBJECT_TYPE
    SecurityInfo As UInteger,   ' OBJECT_SECURITY_INFORMATION
    psidOwner As IntPtr,   ' PSID optional
    psidGroup As IntPtr,   ' PSID optional
    pDacl As IntPtr,   ' ACL* optional
    pSacl As IntPtr   ' ACL* optional
) As UInteger
End Function

' handle : HANDLE
' ObjectType : SE_OBJECT_TYPE
' SecurityInfo : OBJECT_SECURITY_INFORMATION
' psidOwner : PSID optional
' psidGroup : PSID optional
' pDacl : ACL* optional
' pSacl : ACL* optional
Declare PtrSafe Function SetSecurityInfo Lib "advapi32" ( _
    ByVal handle As LongPtr, _
    ByVal ObjectType As Long, _
    ByVal SecurityInfo As Long, _
    ByVal psidOwner As LongPtr, _
    ByVal psidGroup As LongPtr, _
    ByVal pDacl As LongPtr, _
    ByVal pSacl As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

SetSecurityInfo = ctypes.windll.advapi32.SetSecurityInfo
SetSecurityInfo.restype = wintypes.DWORD
SetSecurityInfo.argtypes = [
    wintypes.HANDLE,  # handle : HANDLE
    ctypes.c_int,  # ObjectType : SE_OBJECT_TYPE
    wintypes.DWORD,  # SecurityInfo : OBJECT_SECURITY_INFORMATION
    wintypes.HANDLE,  # psidOwner : PSID optional
    wintypes.HANDLE,  # psidGroup : PSID optional
    ctypes.c_void_p,  # pDacl : ACL* optional
    ctypes.c_void_p,  # pSacl : ACL* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
SetSecurityInfo = Fiddle::Function.new(
  lib['SetSecurityInfo'],
  [
    Fiddle::TYPE_VOIDP,  # handle : HANDLE
    Fiddle::TYPE_INT,  # ObjectType : SE_OBJECT_TYPE
    -Fiddle::TYPE_INT,  # SecurityInfo : OBJECT_SECURITY_INFORMATION
    Fiddle::TYPE_VOIDP,  # psidOwner : PSID optional
    Fiddle::TYPE_VOIDP,  # psidGroup : PSID optional
    Fiddle::TYPE_VOIDP,  # pDacl : ACL* optional
    Fiddle::TYPE_VOIDP,  # pSacl : ACL* optional
  ],
  -Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn SetSecurityInfo(
        handle: *mut core::ffi::c_void,  // HANDLE
        ObjectType: i32,  // SE_OBJECT_TYPE
        SecurityInfo: u32,  // OBJECT_SECURITY_INFORMATION
        psidOwner: *mut core::ffi::c_void,  // PSID optional
        psidGroup: *mut core::ffi::c_void,  // PSID optional
        pDacl: *mut ACL,  // ACL* optional
        pSacl: *mut ACL  // ACL* optional
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ADVAPI32.dll")]
public static extern uint SetSecurityInfo(IntPtr handle, int ObjectType, uint SecurityInfo, IntPtr psidOwner, IntPtr psidGroup, IntPtr pDacl, IntPtr pSacl);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_SetSecurityInfo' -Namespace Win32 -PassThru
# $api::SetSecurityInfo(handle, ObjectType, SecurityInfo, psidOwner, psidGroup, pDacl, pSacl)

#uselib "ADVAPI32.dll"
#func global SetSecurityInfo "SetSecurityInfo" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; SetSecurityInfo handle, ObjectType, SecurityInfo, psidOwner, psidGroup, varptr(pDacl), varptr(pSacl)   ; 戻り値は stat
; handle : HANDLE -> "sptr"
; ObjectType : SE_OBJECT_TYPE -> "sptr"
; SecurityInfo : OBJECT_SECURITY_INFORMATION -> "sptr"
; psidOwner : PSID optional -> "sptr"
; psidGroup : PSID optional -> "sptr"
; pDacl : ACL* optional -> "sptr"
; pSacl : ACL* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ADVAPI32.dll"
#cfunc global SetSecurityInfo "SetSecurityInfo" sptr, int, int, sptr, sptr, var, var
; res = SetSecurityInfo(handle, ObjectType, SecurityInfo, psidOwner, psidGroup, pDacl, pSacl)
; handle : HANDLE -> "sptr"
; ObjectType : SE_OBJECT_TYPE -> "int"
; SecurityInfo : OBJECT_SECURITY_INFORMATION -> "int"
; psidOwner : PSID optional -> "sptr"
; psidGroup : PSID optional -> "sptr"
; pDacl : ACL* optional -> "var"
; pSacl : ACL* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll"
#cfunc global SetSecurityInfo "SetSecurityInfo" sptr, int, int, sptr, sptr, sptr, sptr
; res = SetSecurityInfo(handle, ObjectType, SecurityInfo, psidOwner, psidGroup, varptr(pDacl), varptr(pSacl))
; handle : HANDLE -> "sptr"
; ObjectType : SE_OBJECT_TYPE -> "int"
; SecurityInfo : OBJECT_SECURITY_INFORMATION -> "int"
; psidOwner : PSID optional -> "sptr"
; psidGroup : PSID optional -> "sptr"
; pDacl : ACL* optional -> "sptr"
; pSacl : ACL* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。