Win32 API 日本語リファレンス
ホームSecurity.Authorization › OBJECTS_AND_NAME_A

OBJECTS_AND_NAME_A

構造体
サイズx64: 32 バイト / x86: 20 バイト

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

フィールド

フィールドサイズx64x86説明
ObjectsPresentSYSTEM_AUDIT_OBJECT_ACE_FLAGS4+0+0

ObjectTypeName メンバーと InheritedObjectTypeName メンバーが文字列を格納しているかどうかを示します。このパラメーターには、次の値の組み合わせを指定できます。

意味
ACE_OBJECT_TYPE_PRESENT
0x1
ObjectTypeName メンバーに文字列が格納されています。
ACE_INHERITED_OBJECT_TYPE_PRESENT
0x2
InheritedObjectTypeName メンバーに文字列が格納されています。
ObjectTypeSE_OBJECT_TYPE4+4+4オブジェクトの種類を示す SE_OBJECT_TYPE 列挙型の値を指定します。
ObjectTypeNameLPSTR8/4+8+8

ACE が適用されるオブジェクトの種類を識別する、null で終わる文字列へのポインターです。

この文字列は、Active Directory スキーマにおける有効な LDAP 表示名でなければなりません。

ObjectsPresent メンバーに ACE_INHERITED_OBJECT_TYPE_PRESENT ビットが設定されていない場合、ObjectTypeName メンバーは無視されます。

InheritedObjectTypeNameLPSTR8/4+16+12

ACE を継承できるオブジェクトの種類を識別する、null で終わる文字列へのポインターです。

この文字列は、Active Directory スキーマにおける有効な LDAP 表示名でなければなりません。

ObjectsPresent メンバーに ACE_INHERITED_OBJECT_TYPE_PRESENT ビットが設定されていない場合、InheritedObjectTypeName メンバーは無視され、すべての種類の子オブジェクトが ACE を継承できます。設定されている場合は、指定された種類のオブジェクトだけが ACE を継承できます。いずれの場合も、継承は ACE_HEADER 構造体の継承フラグと、子オブジェクトに設定された継承に対する保護によっても制御されます。

ptstrNameLPSTR8/4+24+16受託者 (trustee) の名前を格納する、null で終わる文字列へのポインターです。

公式ドキュメント

OBJECTS_AND_NAME 構造体は、受託者 (trustee) を名前で識別する文字列と、オブジェクト固有のアクセス制御エントリ (ACE) のオブジェクト型を識別する追加の文字列を格納します。

解説(Remarks)

TrusteeFormTRUSTEE_IS_OBJECTS_AND_NAME である場合、TRUSTEE_A 構造体の ptstrName メンバーは OBJECTS_AND_NAME_A 構造体へのポインターになります。これにより、SetEntriesInAclGetExplicitEntriesFromAcl などの関数が、オブジェクト固有の ACE 情報を EXPLICIT_ACCESS 構造体の Trustee メンバーに格納できるようになります。

メモ

accctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして OBJECTS_AND_NAME_ を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// OBJECTS_AND_NAME_A  (x64 32 / x86 20 バイト)
typedef struct OBJECTS_AND_NAME_A {
    SYSTEM_AUDIT_OBJECT_ACE_FLAGS ObjectsPresent;
    SE_OBJECT_TYPE ObjectType;
    LPSTR ObjectTypeName;
    LPSTR InheritedObjectTypeName;
    LPSTR ptstrName;
} OBJECTS_AND_NAME_A;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OBJECTS_AND_NAME_A
{
    public uint ObjectsPresent;
    public int ObjectType;
    public IntPtr ObjectTypeName;
    public IntPtr InheritedObjectTypeName;
    public IntPtr ptstrName;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OBJECTS_AND_NAME_A
    Public ObjectsPresent As UInteger
    Public ObjectType As Integer
    Public ObjectTypeName As IntPtr
    Public InheritedObjectTypeName As IntPtr
    Public ptstrName As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class OBJECTS_AND_NAME_A(ctypes.Structure):
    _fields_ = [
        ("ObjectsPresent", wintypes.DWORD),
        ("ObjectType", ctypes.c_int),
        ("ObjectTypeName", ctypes.c_void_p),
        ("InheritedObjectTypeName", ctypes.c_void_p),
        ("ptstrName", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct OBJECTS_AND_NAME_A {
    pub ObjectsPresent: u32,
    pub ObjectType: i32,
    pub ObjectTypeName: *mut core::ffi::c_void,
    pub InheritedObjectTypeName: *mut core::ffi::c_void,
    pub ptstrName: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type OBJECTS_AND_NAME_A struct {
	ObjectsPresent uint32
	ObjectType int32
	ObjectTypeName uintptr
	InheritedObjectTypeName uintptr
	ptstrName uintptr
}
type
  OBJECTS_AND_NAME_A = record
    ObjectsPresent: DWORD;
    ObjectType: Integer;
    ObjectTypeName: Pointer;
    InheritedObjectTypeName: Pointer;
    ptstrName: Pointer;
  end;
const OBJECTS_AND_NAME_A = extern struct {
    ObjectsPresent: u32,
    ObjectType: i32,
    ObjectTypeName: ?*anyopaque,
    InheritedObjectTypeName: ?*anyopaque,
    ptstrName: ?*anyopaque,
};
type
  OBJECTS_AND_NAME_A {.bycopy.} = object
    ObjectsPresent: uint32
    ObjectType: int32
    ObjectTypeName: pointer
    InheritedObjectTypeName: pointer
    ptstrName: pointer
struct OBJECTS_AND_NAME_A
{
    uint ObjectsPresent;
    int ObjectType;
    void* ObjectTypeName;
    void* InheritedObjectTypeName;
    void* ptstrName;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OBJECTS_AND_NAME_A サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; ObjectsPresent : SYSTEM_AUDIT_OBJECT_ACE_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ObjectType : SE_OBJECT_TYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ObjectTypeName : LPSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; InheritedObjectTypeName : LPSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ptstrName : LPSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OBJECTS_AND_NAME_A サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; ObjectsPresent : SYSTEM_AUDIT_OBJECT_ACE_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ObjectType : SE_OBJECT_TYPE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ObjectTypeName : LPSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; InheritedObjectTypeName : LPSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ptstrName : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global OBJECTS_AND_NAME_A
    #field int ObjectsPresent
    #field int ObjectType
    #field intptr ObjectTypeName
    #field intptr InheritedObjectTypeName
    #field intptr ptstrName
#endstruct

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