Win32 API 日本語リファレンス
ホームSecurity.Authentication.Identity › CENTRAL_ACCESS_POLICY

CENTRAL_ACCESS_POLICY

構造体
サイズx64: 72 バイト / x86: 40 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
CAPIDPSID8/4+0+0中央アクセスポリシーを識別するSID(CAPID)。
NameLSA_UNICODE_STRING16/8+8+4ポリシーの名前(LSA_UNICODE_STRING)。
DescriptionLSA_UNICODE_STRING16/8+24+12ポリシーの説明文(LSA_UNICODE_STRING)。
ChangeIdLSA_UNICODE_STRING16/8+40+20ポリシーの変更を追跡する識別子(LSA_UNICODE_STRING)。
FlagsDWORD4+56+28ポリシーに関するフラグ。
CAPECountDWORD4+60+32CAPEs配列に含まれる規則エントリ数。
CAPEsCENTRAL_ACCESS_POLICY_ENTRY**8/4+64+36ポリシーを構成する規則エントリへのポインタ配列。

各言語での定義

#include <windows.h>

// LSA_UNICODE_STRING  (x64 16 / x86 8 バイト)
typedef struct LSA_UNICODE_STRING {
    WORD Length;
    WORD MaximumLength;
    LPWSTR Buffer;
} LSA_UNICODE_STRING;

// CENTRAL_ACCESS_POLICY  (x64 72 / x86 40 バイト)
typedef struct CENTRAL_ACCESS_POLICY {
    PSID CAPID;
    LSA_UNICODE_STRING Name;
    LSA_UNICODE_STRING Description;
    LSA_UNICODE_STRING ChangeId;
    DWORD Flags;
    DWORD CAPECount;
    CENTRAL_ACCESS_POLICY_ENTRY** CAPEs;
} CENTRAL_ACCESS_POLICY;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LSA_UNICODE_STRING
{
    public ushort Length;
    public ushort MaximumLength;
    public IntPtr Buffer;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CENTRAL_ACCESS_POLICY
{
    public IntPtr CAPID;
    public LSA_UNICODE_STRING Name;
    public LSA_UNICODE_STRING Description;
    public LSA_UNICODE_STRING ChangeId;
    public uint Flags;
    public uint CAPECount;
    public IntPtr CAPEs;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LSA_UNICODE_STRING
    Public Length As UShort
    Public MaximumLength As UShort
    Public Buffer As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CENTRAL_ACCESS_POLICY
    Public CAPID As IntPtr
    Public Name As LSA_UNICODE_STRING
    Public Description As LSA_UNICODE_STRING
    Public ChangeId As LSA_UNICODE_STRING
    Public Flags As UInteger
    Public CAPECount As UInteger
    Public CAPEs As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class LSA_UNICODE_STRING(ctypes.Structure):
    _fields_ = [
        ("Length", ctypes.c_ushort),
        ("MaximumLength", ctypes.c_ushort),
        ("Buffer", ctypes.c_void_p),
    ]

class CENTRAL_ACCESS_POLICY(ctypes.Structure):
    _fields_ = [
        ("CAPID", ctypes.c_void_p),
        ("Name", LSA_UNICODE_STRING),
        ("Description", LSA_UNICODE_STRING),
        ("ChangeId", LSA_UNICODE_STRING),
        ("Flags", wintypes.DWORD),
        ("CAPECount", wintypes.DWORD),
        ("CAPEs", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct LSA_UNICODE_STRING {
    pub Length: u16,
    pub MaximumLength: u16,
    pub Buffer: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct CENTRAL_ACCESS_POLICY {
    pub CAPID: *mut core::ffi::c_void,
    pub Name: LSA_UNICODE_STRING,
    pub Description: LSA_UNICODE_STRING,
    pub ChangeId: LSA_UNICODE_STRING,
    pub Flags: u32,
    pub CAPECount: u32,
    pub CAPEs: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type LSA_UNICODE_STRING struct {
	Length uint16
	MaximumLength uint16
	Buffer uintptr
}

type CENTRAL_ACCESS_POLICY struct {
	CAPID uintptr
	Name LSA_UNICODE_STRING
	Description LSA_UNICODE_STRING
	ChangeId LSA_UNICODE_STRING
	Flags uint32
	CAPECount uint32
	CAPEs uintptr
}
type
  LSA_UNICODE_STRING = record
    Length: Word;
    MaximumLength: Word;
    Buffer: Pointer;
  end;

  CENTRAL_ACCESS_POLICY = record
    CAPID: Pointer;
    Name: LSA_UNICODE_STRING;
    Description: LSA_UNICODE_STRING;
    ChangeId: LSA_UNICODE_STRING;
    Flags: DWORD;
    CAPECount: DWORD;
    CAPEs: Pointer;
  end;
const LSA_UNICODE_STRING = extern struct {
    Length: u16,
    MaximumLength: u16,
    Buffer: ?*anyopaque,
};

const CENTRAL_ACCESS_POLICY = extern struct {
    CAPID: ?*anyopaque,
    Name: LSA_UNICODE_STRING,
    Description: LSA_UNICODE_STRING,
    ChangeId: LSA_UNICODE_STRING,
    Flags: u32,
    CAPECount: u32,
    CAPEs: ?*anyopaque,
};
type
  LSA_UNICODE_STRING {.bycopy.} = object
    Length: uint16
    MaximumLength: uint16
    Buffer: pointer

  CENTRAL_ACCESS_POLICY {.bycopy.} = object
    CAPID: pointer
    Name: LSA_UNICODE_STRING
    Description: LSA_UNICODE_STRING
    ChangeId: LSA_UNICODE_STRING
    Flags: uint32
    CAPECount: uint32
    CAPEs: pointer
struct LSA_UNICODE_STRING
{
    ushort Length;
    ushort MaximumLength;
    void* Buffer;
}

struct CENTRAL_ACCESS_POLICY
{
    void* CAPID;
    LSA_UNICODE_STRING Name;
    LSA_UNICODE_STRING Description;
    LSA_UNICODE_STRING ChangeId;
    uint Flags;
    uint CAPECount;
    void* CAPEs;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CENTRAL_ACCESS_POLICY サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; CAPID : PSID (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Name : LSA_UNICODE_STRING (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; Description : LSA_UNICODE_STRING (+12, 8byte)  varptr(st)+12 を基点に操作(8byte:入れ子/配列)
; ChangeId : LSA_UNICODE_STRING (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; Flags : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; CAPECount : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; CAPEs : CENTRAL_ACCESS_POLICY_ENTRY** (+36, 4byte)  varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CENTRAL_ACCESS_POLICY サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; CAPID : PSID (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; Name : LSA_UNICODE_STRING (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; Description : LSA_UNICODE_STRING (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; ChangeId : LSA_UNICODE_STRING (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; Flags : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; CAPECount : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; CAPEs : CENTRAL_ACCESS_POLICY_ENTRY** (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global LSA_UNICODE_STRING
    #field short Length
    #field short MaximumLength
    #field intptr Buffer
#endstruct

#defstruct global CENTRAL_ACCESS_POLICY
    #field intptr CAPID
    #field LSA_UNICODE_STRING Name
    #field LSA_UNICODE_STRING Description
    #field LSA_UNICODE_STRING ChangeId
    #field int Flags
    #field int CAPECount
    #field intptr CAPEs
#endstruct

stdim st, CENTRAL_ACCESS_POLICY        ; NSTRUCT 変数を確保
st->Flags = 100
mes "Flags=" + st->Flags