MakeAbsoluteSD

関数

自己相対形式のセキュリティ記述子を絶対形式に変換する。

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

シグネチャ

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

BOOL MakeAbsoluteSD(
    PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor,
    PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor,   // optional
    DWORD* lpdwAbsoluteSecurityDescriptorSize,
    ACL* pDacl,   // optional
    DWORD* lpdwDaclSize,
    ACL* pSacl,   // optional
    DWORD* lpdwSaclSize,
    PSID pOwner,   // optional
    DWORD* lpdwOwnerSize,
    PSID pPrimaryGroup,   // optional
    DWORD* lpdwPrimaryGroupSize
);

パラメーター

名前	型	方向	説明
pSelfRelativeSecurityDescriptor	PSECURITY_DESCRIPTOR	in	自己相対形式の SECURITY_DESCRIPTOR 構造体へのポインターです。この関数は、元のセキュリティ記述子を変更することなく、このセキュリティ記述子の絶対形式バージョンを作成します。
pAbsoluteSecurityDescriptor	PSECURITY_DESCRIPTOR	outoptional	絶対形式セキュリティ記述子の本体で関数が埋めるバッファーへのポインターです。この情報は SECURITY_DESCRIPTOR 構造体として書式化されます。
lpdwAbsoluteSecurityDescriptorSize	DWORD*	inout	pAbsoluteSD パラメーターが指すバッファーのサイズを指定する変数へのポインターです。バッファーがセキュリティ記述子に対して十分な大きさでない場合、関数は失敗し、この変数に必要な最小サイズを設定します。
pDacl	ACL*	outoptional	絶対形式セキュリティ記述子の随意アクセス制御リスト (DACL) で関数が埋めるバッファーへのポインターです。絶対形式セキュリティ記述子の本体は、このポインターを参照します。
lpdwDaclSize	DWORD*	inout	pDacl パラメーターが指すバッファーのサイズを指定する変数へのポインターです。バッファーがアクセス制御リスト (ACL) に対して十分な大きさでない場合、関数は失敗し、この変数に必要な最小サイズを設定します。
pSacl	ACL*	outoptional	絶対形式セキュリティ記述子のシステムアクセス制御リスト (SACL) で関数が埋めるバッファーへのポインターです。絶対形式セキュリティ記述子の本体は、このポインターを参照します。
lpdwSaclSize	DWORD*	inout	pSacl パラメーターが指すバッファーのサイズを指定する変数へのポインターです。バッファーが ACL に対して十分な大きさでない場合、関数は失敗し、この変数に必要な最小サイズを設定します。
pOwner	PSID	outoptional	絶対形式セキュリティ記述子の所有者のセキュリティ識別子 (SID) で関数が埋めるバッファーへのポインターです。絶対形式セキュリティ記述子の本体は、このポインターを参照します。
lpdwOwnerSize	DWORD*	inout	pOwner パラメーターが指すバッファーのサイズを指定する変数へのポインターです。バッファーが SID に対して十分な大きさでない場合、関数は失敗し、この変数に必要な最小サイズを設定します。
pPrimaryGroup	PSID	outoptional	絶対形式セキュリティ記述子のプライマリグループの SID で関数が埋めるバッファーへのポインターです。絶対形式セキュリティ記述子の本体は、このポインターを参照します。
lpdwPrimaryGroupSize	DWORD*	inout	pPrimaryGroup パラメーターが指すバッファーのサイズを指定する変数へのポインターです。バッファーが SID に対して十分な大きさでない場合、関数は失敗し、この変数に必要な最小サイズを設定します。

戻り値の型: BOOL

公式ドキュメント

自己相対形式のセキュリティ記述子をテンプレートとして使用し、絶対形式のセキュリティ記述子を作成します。

戻り値

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

関数が失敗した場合は、0 を返します。拡張エラー情報を取得するには、 GetLastError を呼び出します。返される可能性のあるコードには、以下のものが含まれますが、これらに限定されません。

戻り値/値	説明
ERROR_INSUFFICIENT_BUFFER 0x7A	1 つ以上のバッファーが小さすぎます。

解説(Remarks)

絶対形式のセキュリティ記述子は、含まれる情報そのものではなく、その情報へのポインターを保持します。自己相対形式のセキュリティ記述子は、連続したメモリブロック内に情報を保持します。自己相対形式のセキュリティ記述子では、 SECURITY_DESCRIPTOR 構造体が常に情報の先頭に位置しますが、セキュリティ記述子のその他の構成要素はこの構造体の後に任意の順序で続けることができます。自己相対形式セキュリティ記述子の構成要素は、メモリアドレスではなく、セキュリティ記述子の先頭からのオフセットで識別されます。この形式は、セキュリティ記述子をフロッピーディスクに保存したり、通信プロトコルによって転送したりする必要がある場合に役立ちます。

さまざまなメディアに保護対象オブジェクトをコピーするサーバーは、MakeAbsoluteSD 関数を使用して自己相対セキュリティ記述子から絶対セキュリティ記述子を作成し、 MakeSelfRelativeSD 関数を使用して絶対セキュリティ記述子から自己相対セキュリティ記述子を作成できます。

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

各言語での呼び出し定義

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

BOOL MakeAbsoluteSD(
    PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor,
    PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor,   // optional
    DWORD* lpdwAbsoluteSecurityDescriptorSize,
    ACL* pDacl,   // optional
    DWORD* lpdwDaclSize,
    ACL* pSacl,   // optional
    DWORD* lpdwSaclSize,
    PSID pOwner,   // optional
    DWORD* lpdwOwnerSize,
    PSID pPrimaryGroup,   // optional
    DWORD* lpdwPrimaryGroupSize
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool MakeAbsoluteSD(
    IntPtr pSelfRelativeSecurityDescriptor,   // PSECURITY_DESCRIPTOR
    IntPtr pAbsoluteSecurityDescriptor,   // PSECURITY_DESCRIPTOR optional, out
    ref uint lpdwAbsoluteSecurityDescriptorSize,   // DWORD* in/out
    IntPtr pDacl,   // ACL* optional, out
    ref uint lpdwDaclSize,   // DWORD* in/out
    IntPtr pSacl,   // ACL* optional, out
    ref uint lpdwSaclSize,   // DWORD* in/out
    IntPtr pOwner,   // PSID optional, out
    ref uint lpdwOwnerSize,   // DWORD* in/out
    IntPtr pPrimaryGroup,   // PSID optional, out
    ref uint lpdwPrimaryGroupSize   // DWORD* in/out
);

<DllImport("ADVAPI32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function MakeAbsoluteSD(
    pSelfRelativeSecurityDescriptor As IntPtr,   ' PSECURITY_DESCRIPTOR
    pAbsoluteSecurityDescriptor As IntPtr,   ' PSECURITY_DESCRIPTOR optional, out
    ByRef lpdwAbsoluteSecurityDescriptorSize As UInteger,   ' DWORD* in/out
    pDacl As IntPtr,   ' ACL* optional, out
    ByRef lpdwDaclSize As UInteger,   ' DWORD* in/out
    pSacl As IntPtr,   ' ACL* optional, out
    ByRef lpdwSaclSize As UInteger,   ' DWORD* in/out
    pOwner As IntPtr,   ' PSID optional, out
    ByRef lpdwOwnerSize As UInteger,   ' DWORD* in/out
    pPrimaryGroup As IntPtr,   ' PSID optional, out
    ByRef lpdwPrimaryGroupSize As UInteger   ' DWORD* in/out
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' pSelfRelativeSecurityDescriptor : PSECURITY_DESCRIPTOR
' pAbsoluteSecurityDescriptor : PSECURITY_DESCRIPTOR optional, out
' lpdwAbsoluteSecurityDescriptorSize : DWORD* in/out
' pDacl : ACL* optional, out
' lpdwDaclSize : DWORD* in/out
' pSacl : ACL* optional, out
' lpdwSaclSize : DWORD* in/out
' pOwner : PSID optional, out
' lpdwOwnerSize : DWORD* in/out
' pPrimaryGroup : PSID optional, out
' lpdwPrimaryGroupSize : DWORD* in/out
Declare PtrSafe Function MakeAbsoluteSD Lib "advapi32" ( _
    ByVal pSelfRelativeSecurityDescriptor As LongPtr, _
    ByVal pAbsoluteSecurityDescriptor As LongPtr, _
    ByRef lpdwAbsoluteSecurityDescriptorSize As Long, _
    ByVal pDacl As LongPtr, _
    ByRef lpdwDaclSize As Long, _
    ByVal pSacl As LongPtr, _
    ByRef lpdwSaclSize As Long, _
    ByVal pOwner As LongPtr, _
    ByRef lpdwOwnerSize As Long, _
    ByVal pPrimaryGroup As LongPtr, _
    ByRef lpdwPrimaryGroupSize As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MakeAbsoluteSD = ctypes.windll.advapi32.MakeAbsoluteSD
MakeAbsoluteSD.restype = wintypes.BOOL
MakeAbsoluteSD.argtypes = [
    wintypes.HANDLE,  # pSelfRelativeSecurityDescriptor : PSECURITY_DESCRIPTOR
    wintypes.HANDLE,  # pAbsoluteSecurityDescriptor : PSECURITY_DESCRIPTOR optional, out
    ctypes.POINTER(wintypes.DWORD),  # lpdwAbsoluteSecurityDescriptorSize : DWORD* in/out
    ctypes.c_void_p,  # pDacl : ACL* optional, out
    ctypes.POINTER(wintypes.DWORD),  # lpdwDaclSize : DWORD* in/out
    ctypes.c_void_p,  # pSacl : ACL* optional, out
    ctypes.POINTER(wintypes.DWORD),  # lpdwSaclSize : DWORD* in/out
    wintypes.HANDLE,  # pOwner : PSID optional, out
    ctypes.POINTER(wintypes.DWORD),  # lpdwOwnerSize : DWORD* in/out
    wintypes.HANDLE,  # pPrimaryGroup : PSID optional, out
    ctypes.POINTER(wintypes.DWORD),  # lpdwPrimaryGroupSize : DWORD* in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
MakeAbsoluteSD = Fiddle::Function.new(
  lib['MakeAbsoluteSD'],
  [
    Fiddle::TYPE_VOIDP,  # pSelfRelativeSecurityDescriptor : PSECURITY_DESCRIPTOR
    Fiddle::TYPE_VOIDP,  # pAbsoluteSecurityDescriptor : PSECURITY_DESCRIPTOR optional, out
    Fiddle::TYPE_VOIDP,  # lpdwAbsoluteSecurityDescriptorSize : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pDacl : ACL* optional, out
    Fiddle::TYPE_VOIDP,  # lpdwDaclSize : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pSacl : ACL* optional, out
    Fiddle::TYPE_VOIDP,  # lpdwSaclSize : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pOwner : PSID optional, out
    Fiddle::TYPE_VOIDP,  # lpdwOwnerSize : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pPrimaryGroup : PSID optional, out
    Fiddle::TYPE_VOIDP,  # lpdwPrimaryGroupSize : DWORD* in/out
  ],
  Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn MakeAbsoluteSD(
        pSelfRelativeSecurityDescriptor: *mut core::ffi::c_void,  // PSECURITY_DESCRIPTOR
        pAbsoluteSecurityDescriptor: *mut core::ffi::c_void,  // PSECURITY_DESCRIPTOR optional, out
        lpdwAbsoluteSecurityDescriptorSize: *mut u32,  // DWORD* in/out
        pDacl: *mut ACL,  // ACL* optional, out
        lpdwDaclSize: *mut u32,  // DWORD* in/out
        pSacl: *mut ACL,  // ACL* optional, out
        lpdwSaclSize: *mut u32,  // DWORD* in/out
        pOwner: *mut core::ffi::c_void,  // PSID optional, out
        lpdwOwnerSize: *mut u32,  // DWORD* in/out
        pPrimaryGroup: *mut core::ffi::c_void,  // PSID optional, out
        lpdwPrimaryGroupSize: *mut u32  // DWORD* in/out
    ) -> 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 MakeAbsoluteSD(IntPtr pSelfRelativeSecurityDescriptor, IntPtr pAbsoluteSecurityDescriptor, ref uint lpdwAbsoluteSecurityDescriptorSize, IntPtr pDacl, ref uint lpdwDaclSize, IntPtr pSacl, ref uint lpdwSaclSize, IntPtr pOwner, ref uint lpdwOwnerSize, IntPtr pPrimaryGroup, ref uint lpdwPrimaryGroupSize);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_MakeAbsoluteSD' -Namespace Win32 -PassThru
# $api::MakeAbsoluteSD(pSelfRelativeSecurityDescriptor, pAbsoluteSecurityDescriptor, lpdwAbsoluteSecurityDescriptorSize, pDacl, lpdwDaclSize, pSacl, lpdwSaclSize, pOwner, lpdwOwnerSize, pPrimaryGroup, lpdwPrimaryGroupSize)

#uselib "ADVAPI32.dll"
#func global MakeAbsoluteSD "MakeAbsoluteSD" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; MakeAbsoluteSD pSelfRelativeSecurityDescriptor, pAbsoluteSecurityDescriptor, varptr(lpdwAbsoluteSecurityDescriptorSize), varptr(pDacl), varptr(lpdwDaclSize), varptr(pSacl), varptr(lpdwSaclSize), pOwner, varptr(lpdwOwnerSize), pPrimaryGroup, varptr(lpdwPrimaryGroupSize)   ; 戻り値は stat
; pSelfRelativeSecurityDescriptor : PSECURITY_DESCRIPTOR -> "sptr"
; pAbsoluteSecurityDescriptor : PSECURITY_DESCRIPTOR optional, out -> "sptr"
; lpdwAbsoluteSecurityDescriptorSize : DWORD* in/out -> "sptr"
; pDacl : ACL* optional, out -> "sptr"
; lpdwDaclSize : DWORD* in/out -> "sptr"
; pSacl : ACL* optional, out -> "sptr"
; lpdwSaclSize : DWORD* in/out -> "sptr"
; pOwner : PSID optional, out -> "sptr"
; lpdwOwnerSize : DWORD* in/out -> "sptr"
; pPrimaryGroup : PSID optional, out -> "sptr"
; lpdwPrimaryGroupSize : DWORD* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ADVAPI32.dll"
#cfunc global MakeAbsoluteSD "MakeAbsoluteSD" sptr, sptr, var, var, var, var, var, sptr, var, sptr, var
; res = MakeAbsoluteSD(pSelfRelativeSecurityDescriptor, pAbsoluteSecurityDescriptor, lpdwAbsoluteSecurityDescriptorSize, pDacl, lpdwDaclSize, pSacl, lpdwSaclSize, pOwner, lpdwOwnerSize, pPrimaryGroup, lpdwPrimaryGroupSize)
; pSelfRelativeSecurityDescriptor : PSECURITY_DESCRIPTOR -> "sptr"
; pAbsoluteSecurityDescriptor : PSECURITY_DESCRIPTOR optional, out -> "sptr"
; lpdwAbsoluteSecurityDescriptorSize : DWORD* in/out -> "var"
; pDacl : ACL* optional, out -> "var"
; lpdwDaclSize : DWORD* in/out -> "var"
; pSacl : ACL* optional, out -> "var"
; lpdwSaclSize : DWORD* in/out -> "var"
; pOwner : PSID optional, out -> "sptr"
; lpdwOwnerSize : DWORD* in/out -> "var"
; pPrimaryGroup : PSID optional, out -> "sptr"
; lpdwPrimaryGroupSize : DWORD* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll"
#cfunc global MakeAbsoluteSD "MakeAbsoluteSD" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; res = MakeAbsoluteSD(pSelfRelativeSecurityDescriptor, pAbsoluteSecurityDescriptor, varptr(lpdwAbsoluteSecurityDescriptorSize), varptr(pDacl), varptr(lpdwDaclSize), varptr(pSacl), varptr(lpdwSaclSize), pOwner, varptr(lpdwOwnerSize), pPrimaryGroup, varptr(lpdwPrimaryGroupSize))
; pSelfRelativeSecurityDescriptor : PSECURITY_DESCRIPTOR -> "sptr"
; pAbsoluteSecurityDescriptor : PSECURITY_DESCRIPTOR optional, out -> "sptr"
; lpdwAbsoluteSecurityDescriptorSize : DWORD* in/out -> "sptr"
; pDacl : ACL* optional, out -> "sptr"
; lpdwDaclSize : DWORD* in/out -> "sptr"
; pSacl : ACL* optional, out -> "sptr"
; lpdwSaclSize : DWORD* in/out -> "sptr"
; pOwner : PSID optional, out -> "sptr"
; lpdwOwnerSize : DWORD* in/out -> "sptr"
; pPrimaryGroup : PSID optional, out -> "sptr"
; lpdwPrimaryGroupSize : DWORD* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。