SI_OBJECT_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwFlags | SI_OBJECT_INFO_FLAGS | 4 | +0 | +0 | ユーザーが利用できる編集オプションを決定するビットフラグのセットです。このメンバーには、次の値の組み合わせを指定できます。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hInstance | HINSTANCE | 8/4 | +8 | +4 | プロパティ シートで使用する文字列リソースを含むモジュールを識別します。 ISecurityInformation::GetAccessRights メソッドおよび ISecurityInformation::GetInheritTypes メソッドでは、表示名として文字列リソースの識別子を指定できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pszServerName | LPWSTR | 8/4 | +16 | +8 | アカウント名と SID を検索するコンピューターの名前を示す、null で終わる Unicode 文字列へのポインターです。この値を NULL にすると、ローカル コンピューターを指定できます。 アクセス制御エディターはこのポインターを解放しません。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pszObjectName | LPWSTR | 8/4 | +24 | +12 | 編集対象のオブジェクトの名前を示す、null で終わる Unicode 文字列へのポインターです。この名前は、詳細セキュリティ プロパティ シートのタイトル、およびアクセス制御エディターが表示するエラー メッセージ ボックスに表示されます。 アクセス制御エディターはこのポインターを解放しません。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pszPageTitle | LPWSTR | 8/4 | +32 | +16 | 基本のセキュリティ プロパティ ページのタイトルとして使用される、null で終わる Unicode 文字列へのポインターです。このメンバーは、dwFlags に SI_PAGE_TITLE フラグが設定されていない限り無視されます。ページ タイトルが指定されていない場合は、既定のタイトルが使用されます。 アクセス制御エディターはこのポインターを解放しません。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| guidObjectType | GUID | 16 | +40 | +20 | オブジェクトの GUID です。このメンバーは、dwFlags に SI_OBJECT_GUID フラグが設定されていない限り無視されます。 |
公式ドキュメント
SI_OBJECT_INFO 構造体は、 ISecurityInformation::GetObjectInformation メソッドが、アクセス制御エディターの初期化に使用する情報を指定するために使用します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SI_OBJECT_INFO (x64 56 / x86 36 バイト)
typedef struct SI_OBJECT_INFO {
SI_OBJECT_INFO_FLAGS dwFlags;
HINSTANCE hInstance;
LPWSTR pszServerName;
LPWSTR pszObjectName;
LPWSTR pszPageTitle;
GUID guidObjectType;
} SI_OBJECT_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SI_OBJECT_INFO
{
public uint dwFlags;
public IntPtr hInstance;
public IntPtr pszServerName;
public IntPtr pszObjectName;
public IntPtr pszPageTitle;
public Guid guidObjectType;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SI_OBJECT_INFO
Public dwFlags As UInteger
Public hInstance As IntPtr
Public pszServerName As IntPtr
Public pszObjectName As IntPtr
Public pszPageTitle As IntPtr
Public guidObjectType As Guid
End Structureimport ctypes
from ctypes import wintypes
class SI_OBJECT_INFO(ctypes.Structure):
_fields_ = [
("dwFlags", wintypes.DWORD),
("hInstance", ctypes.c_void_p),
("pszServerName", ctypes.c_void_p),
("pszObjectName", ctypes.c_void_p),
("pszPageTitle", ctypes.c_void_p),
("guidObjectType", GUID),
]#[repr(C)]
pub struct SI_OBJECT_INFO {
pub dwFlags: u32,
pub hInstance: *mut core::ffi::c_void,
pub pszServerName: *mut core::ffi::c_void,
pub pszObjectName: *mut core::ffi::c_void,
pub pszPageTitle: *mut core::ffi::c_void,
pub guidObjectType: GUID,
}import "golang.org/x/sys/windows"
type SI_OBJECT_INFO struct {
dwFlags uint32
hInstance uintptr
pszServerName uintptr
pszObjectName uintptr
pszPageTitle uintptr
guidObjectType windows.GUID
}type
SI_OBJECT_INFO = record
dwFlags: DWORD;
hInstance: Pointer;
pszServerName: Pointer;
pszObjectName: Pointer;
pszPageTitle: Pointer;
guidObjectType: TGUID;
end;const SI_OBJECT_INFO = extern struct {
dwFlags: u32,
hInstance: ?*anyopaque,
pszServerName: ?*anyopaque,
pszObjectName: ?*anyopaque,
pszPageTitle: ?*anyopaque,
guidObjectType: GUID,
};type
SI_OBJECT_INFO {.bycopy.} = object
dwFlags: uint32
hInstance: pointer
pszServerName: pointer
pszObjectName: pointer
pszPageTitle: pointer
guidObjectType: GUIDstruct SI_OBJECT_INFO
{
uint dwFlags;
void* hInstance;
void* pszServerName;
void* pszObjectName;
void* pszPageTitle;
GUID guidObjectType;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SI_OBJECT_INFO サイズ: 36 バイト(x86)
dim st, 9 ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; dwFlags : SI_OBJECT_INFO_FLAGS (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hInstance : HINSTANCE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pszServerName : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; pszObjectName : LPWSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pszPageTitle : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; guidObjectType : GUID (+20, 16byte) varptr(st)+20 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SI_OBJECT_INFO サイズ: 56 バイト(x64)
dim st, 14 ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwFlags : SI_OBJECT_INFO_FLAGS (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hInstance : HINSTANCE (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pszServerName : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pszObjectName : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pszPageTitle : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; guidObjectType : GUID (+40, 16byte) varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global SI_OBJECT_INFO
#field int dwFlags
#field intptr hInstance
#field intptr pszServerName
#field intptr pszObjectName
#field intptr pszPageTitle
#field GUID guidObjectType
#endstruct
stdim st, SI_OBJECT_INFO ; NSTRUCT 変数を確保
st->dwFlags = 100
mes "dwFlags=" + st->dwFlags