InitializeSid

関数

指定した識別子機関とサブ権限数でSIDを初期化する。

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

シグネチャ

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

BOOL InitializeSid(
    PSID Sid,
    SID_IDENTIFIER_AUTHORITY* pIdentifierAuthority,
    BYTE nSubAuthorityCount
);

パラメーター

名前	型	方向
Sid	PSID	out
pIdentifierAuthority	SID_IDENTIFIER_AUTHORITY*	in
nSubAuthorityCount	BYTE	in

戻り値の型: BOOL

各言語での呼び出し定義

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

BOOL InitializeSid(
    PSID Sid,
    SID_IDENTIFIER_AUTHORITY* pIdentifierAuthority,
    BYTE nSubAuthorityCount
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ADVAPI32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool InitializeSid(
    IntPtr Sid,   // PSID out
    IntPtr pIdentifierAuthority,   // SID_IDENTIFIER_AUTHORITY*
    byte nSubAuthorityCount   // BYTE
);

<DllImport("ADVAPI32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function InitializeSid(
    Sid As IntPtr,   ' PSID out
    pIdentifierAuthority As IntPtr,   ' SID_IDENTIFIER_AUTHORITY*
    nSubAuthorityCount As Byte   ' BYTE
) As Boolean
End Function

' Sid : PSID out
' pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY*
' nSubAuthorityCount : BYTE
Declare PtrSafe Function InitializeSid Lib "advapi32" ( _
    ByVal Sid As LongPtr, _
    ByVal pIdentifierAuthority As LongPtr, _
    ByVal nSubAuthorityCount As Byte) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

InitializeSid = ctypes.windll.advapi32.InitializeSid
InitializeSid.restype = wintypes.BOOL
InitializeSid.argtypes = [
    wintypes.HANDLE,  # Sid : PSID out
    ctypes.c_void_p,  # pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY*
    ctypes.c_ubyte,  # nSubAuthorityCount : BYTE
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ADVAPI32.dll')
InitializeSid = Fiddle::Function.new(
  lib['InitializeSid'],
  [
    Fiddle::TYPE_VOIDP,  # Sid : PSID out
    Fiddle::TYPE_VOIDP,  # pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY*
    -Fiddle::TYPE_CHAR,  # nSubAuthorityCount : BYTE
  ],
  Fiddle::TYPE_INT)

#[link(name = "advapi32")]
extern "system" {
    fn InitializeSid(
        Sid: *mut core::ffi::c_void,  // PSID out
        pIdentifierAuthority: *mut SID_IDENTIFIER_AUTHORITY,  // SID_IDENTIFIER_AUTHORITY*
        nSubAuthorityCount: u8  // BYTE
    ) -> 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 InitializeSid(IntPtr Sid, IntPtr pIdentifierAuthority, byte nSubAuthorityCount);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ADVAPI32_InitializeSid' -Namespace Win32 -PassThru
# $api::InitializeSid(Sid, pIdentifierAuthority, nSubAuthorityCount)

#uselib "ADVAPI32.dll"
#func global InitializeSid "InitializeSid" sptr, sptr, sptr
; InitializeSid Sid, varptr(pIdentifierAuthority), nSubAuthorityCount   ; 戻り値は stat
; Sid : PSID out -> "sptr"
; pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "sptr"
; nSubAuthorityCount : BYTE -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

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

出力引数:

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

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

var (
	advapi32 = windows.NewLazySystemDLL("ADVAPI32.dll")
	procInitializeSid = advapi32.NewProc("InitializeSid")
)

// Sid (PSID out), pIdentifierAuthority (SID_IDENTIFIER_AUTHORITY*), nSubAuthorityCount (BYTE)
r1, _, err := procInitializeSid.Call(
	uintptr(Sid),
	uintptr(pIdentifierAuthority),
	uintptr(nSubAuthorityCount),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL

function InitializeSid(
  Sid: THandle;   // PSID out
  pIdentifierAuthority: Pointer;   // SID_IDENTIFIER_AUTHORITY*
  nSubAuthorityCount: Byte   // BYTE
): BOOL; stdcall;
  external 'ADVAPI32.dll' name 'InitializeSid';

result := DllCall("ADVAPI32\InitializeSid"
    , "Ptr", Sid   ; PSID out
    , "Ptr", pIdentifierAuthority   ; SID_IDENTIFIER_AUTHORITY*
    , "UChar", nSubAuthorityCount   ; BYTE
    , "Int")   ; return: BOOL

●InitializeSid(Sid, pIdentifierAuthority, nSubAuthorityCount) = DLL("ADVAPI32.dll", "bool InitializeSid(void*, void*, byte)")
# 呼び出し: InitializeSid(Sid, pIdentifierAuthority, nSubAuthorityCount)
# Sid : PSID out -> "void*"
# pIdentifierAuthority : SID_IDENTIFIER_AUTHORITY* -> "void*"
# nSubAuthorityCount : BYTE -> "byte"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。