SECURITY_ATTRIBUTES
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| nLength | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。この値には SECURITY_ATTRIBUTES 構造体のサイズを設定します。 |
| lpSecurityDescriptor | void* | 8/4 | +8 | +4 | オブジェクトへのアクセスを制御する SECURITY_DESCRIPTOR 構造体へのポインターです。このメンバーの値が NULL の場合、オブジェクトには呼び出し元プロセスの アクセス トークン に関連付けられた既定のセキュリティ記述子が割り当てられます。これは、NULL の 随意アクセス制御リスト (DACL) を割り当てて全員にアクセスを許可することとは異なります。既定では、プロセスのアクセス トークン内の既定の DACL は、そのアクセス トークンが表すユーザーにのみアクセスを許可します。 セキュリティ記述子の作成については、「セキュリティ記述子の作成」を参照してください。 |
| bInheritHandle | BOOL | 4 | +16 | +8 | 新しいプロセスが作成されるときに、返されたハンドルが継承されるかどうかを指定するブール値です。このメンバーが TRUE の場合、新しいプロセスはハンドルを継承します。 |
公式ドキュメント
SECURITY_ATTRIBUTES 構造体は、オブジェクトの セキュリティ記述子 を格納し、この構造体を指定して取得されるハンドルが継承可能かどうかを指定します。この構造体は、CreateFile、CreatePipe、CreateProcess、RegCreateKeyEx、RegSaveKeyEx など、さまざまな関数によって作成されるオブジェクトに対するセキュリティ設定を提供します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SECURITY_ATTRIBUTES (x64 24 / x86 12 バイト)
typedef struct SECURITY_ATTRIBUTES {
DWORD nLength;
void* lpSecurityDescriptor;
BOOL bInheritHandle;
} SECURITY_ATTRIBUTES;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SECURITY_ATTRIBUTES
{
public uint nLength;
public IntPtr lpSecurityDescriptor;
[MarshalAs(UnmanagedType.Bool)] public bool bInheritHandle;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SECURITY_ATTRIBUTES
Public nLength As UInteger
Public lpSecurityDescriptor As IntPtr
<MarshalAs(UnmanagedType.Bool)> Public bInheritHandle As Boolean
End Structureimport ctypes
from ctypes import wintypes
class SECURITY_ATTRIBUTES(ctypes.Structure):
_fields_ = [
("nLength", wintypes.DWORD),
("lpSecurityDescriptor", ctypes.c_void_p),
("bInheritHandle", wintypes.BOOL),
]#[repr(C)]
pub struct SECURITY_ATTRIBUTES {
pub nLength: u32,
pub lpSecurityDescriptor: *mut core::ffi::c_void,
pub bInheritHandle: i32,
}import "golang.org/x/sys/windows"
type SECURITY_ATTRIBUTES struct {
nLength uint32
lpSecurityDescriptor uintptr
bInheritHandle int32
}type
SECURITY_ATTRIBUTES = record
nLength: DWORD;
lpSecurityDescriptor: Pointer;
bInheritHandle: BOOL;
end;const SECURITY_ATTRIBUTES = extern struct {
nLength: u32,
lpSecurityDescriptor: ?*anyopaque,
bInheritHandle: i32,
};type
SECURITY_ATTRIBUTES {.bycopy.} = object
nLength: uint32
lpSecurityDescriptor: pointer
bInheritHandle: int32struct SECURITY_ATTRIBUTES
{
uint nLength;
void* lpSecurityDescriptor;
int bInheritHandle;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SECURITY_ATTRIBUTES サイズ: 12 バイト(x86)
dim st, 3 ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; nLength : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; lpSecurityDescriptor : void* (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; bInheritHandle : BOOL (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SECURITY_ATTRIBUTES サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; nLength : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; lpSecurityDescriptor : void* (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; bInheritHandle : BOOL (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SECURITY_ATTRIBUTES
#field int nLength
#field intptr lpSecurityDescriptor
#field bool bInheritHandle
#endstruct
stdim st, SECURITY_ATTRIBUTES ; NSTRUCT 変数を確保
st->nLength = 100
mes "nLength=" + st->nLength