ACL
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| AclRevision | BYTE | 1 | +0 | +0 | ACL のリビジョン レベルを指定します。この値は通常 ACL_REVISION です。ただし、ACL にオブジェクト固有の ACE が含まれる場合、この値は ACL_REVISION_DS でなければなりません。ACL 内のすべての ACE は同じリビジョン レベルでなければなりません。 |
| Sbz1 | BYTE | 1 | +1 | +1 | AclRevision メンバーを 16 ビット境界に整列させる、0 のパディング 1 バイトを指定します。 |
| AclSize | WORD | 2 | +2 | +2 | ACL のサイズをバイト単位で指定します。この値には、ACL 構造体、すべての ACE、および未使用となる可能性のあるメモリが含まれます。 |
| AceCount | WORD | 2 | +4 | +4 | ACL に格納されている ACE の数を指定します。 |
| Sbz2 | WORD | 2 | +6 | +6 | ACL 構造体を 32 ビット境界に整列させる、0 のパディング 2 バイトを指定します。 |
公式ドキュメント
ACL 構造体は、アクセス制御リスト (ACL) のヘッダーです。完全な ACL は、ACL 構造体と、それに続く 0 個以上の アクセス制御エントリ (ACE) の順序付きリストで構成されます。
解説(Remarks)
ACL には、0 個以上の ACE の連続したリストが含まれます。ACL 内の個々の ACE には 0 から n までの番号が付けられ、n+1 が ACL 内の ACE の数になります。ACL を編集する際、アプリケーションは ACE のインデックスによって ACL 内の ACE を参照します。
ACL には、随意 (discretionary) とシステムの 2 種類があります。
随意アクセス制御リスト (DACL) は、オブジェクトの所有者、またはそのオブジェクトに対する WRITE_DAC アクセスを許可された者によって制御されます。DACL は、特定のユーザーやグループがオブジェクトに対して持つことのできるアクセスを指定します。たとえば、ファイルの所有者は DACL を使用して、どのユーザーおよびグループがそのファイルにアクセスできるか、またはできないかを制御できます。
オブジェクトには、システム管理者によって制御される システム アクセス制御リスト (SACL) という形式で、システム レベルのセキュリティ情報を関連付けることもできます。SACL により、システム管理者はオブジェクトへのアクセス試行を監査できます。
現在定義されている ACE 構造体の一覧については、ACE を参照してください。
4 番目の ACE 構造体である SYSTEM_ALARM_ACE は、現在サポートされていません。
ACL 構造体は不透明なものとして扱う必要があり、アプリケーションはそのメンバーを直接操作しようとしてはなりません。ACL が意味的に正しいことを保証するため、アプリケーションは「関連項目」セクションに挙げられている関数を使用して ACL を作成および操作できます。
各 ACL 構造体および ACE 構造体は、DWORD 境界から始まります。
ACL の最大サイズは、その ACE を含めて 64 KB です。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// ACL (x64 8 / x86 8 バイト)
typedef struct ACL {
BYTE AclRevision;
BYTE Sbz1;
WORD AclSize;
WORD AceCount;
WORD Sbz2;
} ACL;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ACL
{
public byte AclRevision;
public byte Sbz1;
public ushort AclSize;
public ushort AceCount;
public ushort Sbz2;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ACL
Public AclRevision As Byte
Public Sbz1 As Byte
Public AclSize As UShort
Public AceCount As UShort
Public Sbz2 As UShort
End Structureimport ctypes
from ctypes import wintypes
class ACL(ctypes.Structure):
_fields_ = [
("AclRevision", ctypes.c_ubyte),
("Sbz1", ctypes.c_ubyte),
("AclSize", ctypes.c_ushort),
("AceCount", ctypes.c_ushort),
("Sbz2", ctypes.c_ushort),
]#[repr(C)]
pub struct ACL {
pub AclRevision: u8,
pub Sbz1: u8,
pub AclSize: u16,
pub AceCount: u16,
pub Sbz2: u16,
}import "golang.org/x/sys/windows"
type ACL struct {
AclRevision byte
Sbz1 byte
AclSize uint16
AceCount uint16
Sbz2 uint16
}type
ACL = record
AclRevision: Byte;
Sbz1: Byte;
AclSize: Word;
AceCount: Word;
Sbz2: Word;
end;const ACL = extern struct {
AclRevision: u8,
Sbz1: u8,
AclSize: u16,
AceCount: u16,
Sbz2: u16,
};type
ACL {.bycopy.} = object
AclRevision: uint8
Sbz1: uint8
AclSize: uint16
AceCount: uint16
Sbz2: uint16struct ACL
{
ubyte AclRevision;
ubyte Sbz1;
ushort AclSize;
ushort AceCount;
ushort Sbz2;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ACL サイズ: 8 バイト(x64)
dim st, 2 ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; AclRevision : BYTE (+0, 1byte) poke st,0,値 / 値 = peek(st,0)
; Sbz1 : BYTE (+1, 1byte) poke st,1,値 / 値 = peek(st,1)
; AclSize : WORD (+2, 2byte) wpoke st,2,値 / 値 = wpeek(st,2)
; AceCount : WORD (+4, 2byte) wpoke st,4,値 / 値 = wpeek(st,4)
; Sbz2 : WORD (+6, 2byte) wpoke st,6,値 / 値 = wpeek(st,6)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ACL
#field byte AclRevision
#field byte Sbz1
#field short AclSize
#field short AceCount
#field short Sbz2
#endstruct
stdim st, ACL ; NSTRUCT 変数を確保
st->AclRevision = 100
mes "AclRevision=" + st->AclRevision