ホーム › Security › AllocateAndInitializeSid

AllocateAndInitializeSid

関数

指定した識別子機関とサブ権限からSIDを割り当て初期化する。

DLLADVAPI32.dll呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// ADVAPI32.dll
#include <windows.h>

BOOL AllocateAndInitializeSid(
    SID_IDENTIFIER_AUTHORITY* pIdentifierAuthority,
    BYTE nSubAuthorityCount,
    DWORD nSubAuthority0,
    DWORD nSubAuthority1,
    DWORD nSubAuthority2,
    DWORD nSubAuthority3,
    DWORD nSubAuthority4,
    DWORD nSubAuthority5,
    DWORD nSubAuthority6,
    DWORD nSubAuthority7,
    PSID* pSid
);

パラメーター

名前	型	方向
pIdentifierAuthority	SID_IDENTIFIER_AUTHORITY*	in
nSubAuthorityCount	BYTE	in
nSubAuthority0	DWORD	in
nSubAuthority1	DWORD	in
nSubAuthority2	DWORD	in
nSubAuthority3	DWORD	in
nSubAuthority4	DWORD	in
nSubAuthority5	DWORD	in
nSubAuthority6	DWORD	in
nSubAuthority7	DWORD	in
pSid	PSID*	out

戻り値の型: BOOL

各言語での呼び出し定義

// ADVAPI32.dll
#include <windows.h>

BOOL AllocateAndInitializeSid(
    SID_IDENTIFIER_AUTHORITY* pIdentifierAuthority,
    BYTE nSubAuthorityCount,
    DWORD nSubAuthority0,
    DWORD nSubAuthority1,
    DWORD nSubAuthority2,
    DWORD nSubAuthority3,
    DWORD nSubAuthority4,
    DWORD nSubAuthority5,
    DWORD nSubAuthority6,
    DWORD nSubAuthority7,
    PSID* pSid
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool AllocateAndInitializeSid(
    IntPtr pIdentifierAuthority,   // SID_IDENTIFIER_AUTHORITY*
    byte nSubAuthorityCount,   // BYTE
    uint nSubAuthority0,   // DWORD
    uint nSubAuthority1,   // DWORD
    uint nSubAuthority2,   // DWORD
    uint nSubAuthority3,   // DWORD
    uint nSubAuthority4,   // DWORD
    uint nSubAuthority5,   // DWORD
    uint nSubAuthority6,   // DWORD
    uint nSubAuthority7,   // DWORD
    IntPtr pSid   // PSID* out
);

<DllImport("ADVAPI32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function AllocateAndInitializeSid(
    pIdentifierAuthority As IntPtr,   ' SID_IDENTIFIER_AUTHORITY*
    nSubAuthorityCount As Byte,   ' BYTE
    nSubAuthority0 As UInteger,   ' DWORD
    nSubAuthority1 As UInteger,   ' DWORD
    nSubAuthority2 As UInteger,   ' DWORD
    nSubAuthority3 As UInteger,   ' DWORD
    nSubAuthority4 As UInteger,   ' DWORD
    nSubAuthority5 As UInteger,   ' DWORD
    nSubAuthority6 As UInteger,   ' DWORD
    nSubAuthority7 As UInteger,   ' DWORD
    pSid As IntPtr   ' PSID* out
) As Boolean
End Function

' pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY*
' nSubAuthorityCount : BYTE
' nSubAuthority0 : DWORD
' nSubAuthority1 : DWORD
' nSubAuthority2 : DWORD
' nSubAuthority3 : DWORD
' nSubAuthority4 : DWORD
' nSubAuthority5 : DWORD
' nSubAuthority6 : DWORD
' nSubAuthority7 : DWORD
' pSid : PSID* out
Declare PtrSafe Function AllocateAndInitializeSid Lib "advapi32" ( _
    ByVal pIdentifierAuthority As LongPtr, _
    ByVal nSubAuthorityCount As Byte, _
    ByVal nSubAuthority0 As Long, _
    ByVal nSubAuthority1 As Long, _
    ByVal nSubAuthority2 As Long, _
    ByVal nSubAuthority3 As Long, _
    ByVal nSubAuthority4 As Long, _
    ByVal nSubAuthority5 As Long, _
    ByVal nSubAuthority6 As Long, _
    ByVal nSubAuthority7 As Long, _
    ByVal pSid As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

AllocateAndInitializeSid = ctypes.windll.advapi32.AllocateAndInitializeSid
AllocateAndInitializeSid.restype = wintypes.BOOL
AllocateAndInitializeSid.argtypes = [
    ctypes.c_void_p,  # pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY*
    ctypes.c_ubyte,  # nSubAuthorityCount : BYTE
    wintypes.DWORD,  # nSubAuthority0 : DWORD
    wintypes.DWORD,  # nSubAuthority1 : DWORD
    wintypes.DWORD,  # nSubAuthority2 : DWORD
    wintypes.DWORD,  # nSubAuthority3 : DWORD
    wintypes.DWORD,  # nSubAuthority4 : DWORD
    wintypes.DWORD,  # nSubAuthority5 : DWORD
    wintypes.DWORD,  # nSubAuthority6 : DWORD
    wintypes.DWORD,  # nSubAuthority7 : DWORD
    ctypes.c_void_p,  # pSid : PSID* out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
AllocateAndInitializeSid = Fiddle::Function.new(
  lib['AllocateAndInitializeSid'],
  [
    Fiddle::TYPE_VOIDP,  # pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY*
    -Fiddle::TYPE_CHAR,  # nSubAuthorityCount : BYTE
    -Fiddle::TYPE_INT,  # nSubAuthority0 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority1 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority2 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority3 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority4 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority5 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority6 : DWORD
    -Fiddle::TYPE_INT,  # nSubAuthority7 : DWORD
    Fiddle::TYPE_VOIDP,  # pSid : PSID* out
  ],
  Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn AllocateAndInitializeSid(
        pIdentifierAuthority: *mut SID_IDENTIFIER_AUTHORITY,  // SID_IDENTIFIER_AUTHORITY*
        nSubAuthorityCount: u8,  // BYTE
        nSubAuthority0: u32,  // DWORD
        nSubAuthority1: u32,  // DWORD
        nSubAuthority2: u32,  // DWORD
        nSubAuthority3: u32,  // DWORD
        nSubAuthority4: u32,  // DWORD
        nSubAuthority5: u32,  // DWORD
        nSubAuthority6: u32,  // DWORD
        nSubAuthority7: u32,  // DWORD
        pSid: *mut *mut core::ffi::c_void  // PSID* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", SetLastError = true)]
public static extern bool AllocateAndInitializeSid(IntPtr pIdentifierAuthority, byte nSubAuthorityCount, uint nSubAuthority0, uint nSubAuthority1, uint nSubAuthority2, uint nSubAuthority3, uint nSubAuthority4, uint nSubAuthority5, uint nSubAuthority6, uint nSubAuthority7, IntPtr pSid);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_AllocateAndInitializeSid' -Namespace Win32 -PassThru
# $api::AllocateAndInitializeSid(pIdentifierAuthority, nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid)

#uselib "ADVAPI32.dll"
#func global AllocateAndInitializeSid "AllocateAndInitializeSid" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; AllocateAndInitializeSid varptr(pIdentifierAuthority), nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid   ; 戻り値は stat
; pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "sptr"
; nSubAuthorityCount : BYTE -> "sptr"
; nSubAuthority0 : DWORD -> "sptr"
; nSubAuthority1 : DWORD -> "sptr"
; nSubAuthority2 : DWORD -> "sptr"
; nSubAuthority3 : DWORD -> "sptr"
; nSubAuthority4 : DWORD -> "sptr"
; nSubAuthority5 : DWORD -> "sptr"
; nSubAuthority6 : DWORD -> "sptr"
; nSubAuthority7 : DWORD -> "sptr"
; pSid : PSID* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ADVAPI32.dll"
#cfunc global AllocateAndInitializeSid "AllocateAndInitializeSid" var, int, int, int, int, int, int, int, int, int, sptr
; res = AllocateAndInitializeSid(pIdentifierAuthority, nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid)
; pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "var"
; nSubAuthorityCount : BYTE -> "int"
; nSubAuthority0 : DWORD -> "int"
; nSubAuthority1 : DWORD -> "int"
; nSubAuthority2 : DWORD -> "int"
; nSubAuthority3 : DWORD -> "int"
; nSubAuthority4 : DWORD -> "int"
; nSubAuthority5 : DWORD -> "int"
; nSubAuthority6 : DWORD -> "int"
; nSubAuthority7 : DWORD -> "int"
; pSid : PSID* out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ADVAPI32.dll"
#cfunc global AllocateAndInitializeSid "AllocateAndInitializeSid" sptr, int, int, int, int, int, int, int, int, int, sptr
; res = AllocateAndInitializeSid(varptr(pIdentifierAuthority), nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid)
; pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "sptr"
; nSubAuthorityCount : BYTE -> "int"
; nSubAuthority0 : DWORD -> "int"
; nSubAuthority1 : DWORD -> "int"
; nSubAuthority2 : DWORD -> "int"
; nSubAuthority3 : DWORD -> "int"
; nSubAuthority4 : DWORD -> "int"
; nSubAuthority5 : DWORD -> "int"
; nSubAuthority6 : DWORD -> "int"
; nSubAuthority7 : DWORD -> "int"
; pSid : PSID* out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; BOOL AllocateAndInitializeSid(SID_IDENTIFIER_AUTHORITY* pIdentifierAuthority, BYTE nSubAuthorityCount, DWORD nSubAuthority0, DWORD nSubAuthority1, DWORD nSubAuthority2, DWORD nSubAuthority3, DWORD nSubAuthority4, DWORD nSubAuthority5, DWORD nSubAuthority6, DWORD nSubAuthority7, PSID* pSid)
#uselib "ADVAPI32.dll"
#cfunc global AllocateAndInitializeSid "AllocateAndInitializeSid" var, int, int, int, int, int, int, int, int, int, intptr
; res = AllocateAndInitializeSid(pIdentifierAuthority, nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid)
; pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "var"
; nSubAuthorityCount : BYTE -> "int"
; nSubAuthority0 : DWORD -> "int"
; nSubAuthority1 : DWORD -> "int"
; nSubAuthority2 : DWORD -> "int"
; nSubAuthority3 : DWORD -> "int"
; nSubAuthority4 : DWORD -> "int"
; nSubAuthority5 : DWORD -> "int"
; nSubAuthority6 : DWORD -> "int"
; nSubAuthority7 : DWORD -> "int"
; pSid : PSID* out -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL AllocateAndInitializeSid(SID_IDENTIFIER_AUTHORITY* pIdentifierAuthority, BYTE nSubAuthorityCount, DWORD nSubAuthority0, DWORD nSubAuthority1, DWORD nSubAuthority2, DWORD nSubAuthority3, DWORD nSubAuthority4, DWORD nSubAuthority5, DWORD nSubAuthority6, DWORD nSubAuthority7, PSID* pSid)
#uselib "ADVAPI32.dll"
#cfunc global AllocateAndInitializeSid "AllocateAndInitializeSid" intptr, int, int, int, int, int, int, int, int, int, intptr
; res = AllocateAndInitializeSid(varptr(pIdentifierAuthority), nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid)
; pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "intptr"
; nSubAuthorityCount : BYTE -> "int"
; nSubAuthority0 : DWORD -> "int"
; nSubAuthority1 : DWORD -> "int"
; nSubAuthority2 : DWORD -> "int"
; nSubAuthority3 : DWORD -> "int"
; nSubAuthority4 : DWORD -> "int"
; nSubAuthority5 : DWORD -> "int"
; nSubAuthority6 : DWORD -> "int"
; nSubAuthority7 : DWORD -> "int"
; pSid : PSID* out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	advapi32 = windows.NewLazySystemDLL("ADVAPI32.dll")
	procAllocateAndInitializeSid = advapi32.NewProc("AllocateAndInitializeSid")
)

// pIdentifierAuthority (SID_IDENTIFIER_AUTHORITY*), nSubAuthorityCount (BYTE), nSubAuthority0 (DWORD), nSubAuthority1 (DWORD), nSubAuthority2 (DWORD), nSubAuthority3 (DWORD), nSubAuthority4 (DWORD), nSubAuthority5 (DWORD), nSubAuthority6 (DWORD), nSubAuthority7 (DWORD), pSid (PSID* out)
r1, _, err := procAllocateAndInitializeSid.Call(
	uintptr(pIdentifierAuthority),
	uintptr(nSubAuthorityCount),
	uintptr(nSubAuthority0),
	uintptr(nSubAuthority1),
	uintptr(nSubAuthority2),
	uintptr(nSubAuthority3),
	uintptr(nSubAuthority4),
	uintptr(nSubAuthority5),
	uintptr(nSubAuthority6),
	uintptr(nSubAuthority7),
	uintptr(pSid),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL

function AllocateAndInitializeSid(
  pIdentifierAuthority: Pointer;   // SID_IDENTIFIER_AUTHORITY*
  nSubAuthorityCount: Byte;   // BYTE
  nSubAuthority0: DWORD;   // DWORD
  nSubAuthority1: DWORD;   // DWORD
  nSubAuthority2: DWORD;   // DWORD
  nSubAuthority3: DWORD;   // DWORD
  nSubAuthority4: DWORD;   // DWORD
  nSubAuthority5: DWORD;   // DWORD
  nSubAuthority6: DWORD;   // DWORD
  nSubAuthority7: DWORD;   // DWORD
  pSid: Pointer   // PSID* out
): BOOL; stdcall;
  external 'ADVAPI32.dll' name 'AllocateAndInitializeSid';

result := DllCall("ADVAPI32\AllocateAndInitializeSid"
    , "Ptr", pIdentifierAuthority   ; SID_IDENTIFIER_AUTHORITY*
    , "UChar", nSubAuthorityCount   ; BYTE
    , "UInt", nSubAuthority0   ; DWORD
    , "UInt", nSubAuthority1   ; DWORD
    , "UInt", nSubAuthority2   ; DWORD
    , "UInt", nSubAuthority3   ; DWORD
    , "UInt", nSubAuthority4   ; DWORD
    , "UInt", nSubAuthority5   ; DWORD
    , "UInt", nSubAuthority6   ; DWORD
    , "UInt", nSubAuthority7   ; DWORD
    , "Ptr", pSid   ; PSID* out
    , "Int")   ; return: BOOL

●AllocateAndInitializeSid(pIdentifierAuthority, nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid) = DLL("ADVAPI32.dll", "bool AllocateAndInitializeSid(void*, byte, dword, dword, dword, dword, dword, dword, dword, dword, void*)")
# 呼び出し: AllocateAndInitializeSid(pIdentifierAuthority, nSubAuthorityCount, nSubAuthority0, nSubAuthority1, nSubAuthority2, nSubAuthority3, nSubAuthority4, nSubAuthority5, nSubAuthority6, nSubAuthority7, pSid)
# pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "void*"
# nSubAuthorityCount : BYTE -> "byte"
# nSubAuthority0 : DWORD -> "dword"
# nSubAuthority1 : DWORD -> "dword"
# nSubAuthority2 : DWORD -> "dword"
# nSubAuthority3 : DWORD -> "dword"
# nSubAuthority4 : DWORD -> "dword"
# nSubAuthority5 : DWORD -> "dword"
# nSubAuthority6 : DWORD -> "dword"
# nSubAuthority7 : DWORD -> "dword"
# pSid : PSID* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。