ホーム › 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	SID_IDENTIFIER_AUTHORITY 構造体へのポインター。この構造体は、SID に設定する最上位の識別子オーソリティ値を指定します。
nSubAuthorityCount	BYTE	in	SID に格納するサブオーソリティの数を指定します。このパラメーターは、サブオーソリティパラメーターのうち何個が有効な値を持つかも示します。このパラメーターには 1 から 8 までの値を指定する必要があります。たとえば、値が 3 の場合は、dwSubAuthority0、dwSubAuthority1、dwSubAuthority2 の各パラメーターで指定されたサブオーソリティ値が有効であり、残りは無視されることを示します。
nSubAuthority0	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority1	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority2	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority3	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority4	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority5	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority6	DWORD	in	SID に格納するサブオーソリティ値。
nSubAuthority7	DWORD	in	SID に格納するサブオーソリティ値。
pSid	PSID*	out	割り当てられて初期化された SID 構造体へのポインターを受け取る変数へのポインター。

戻り値の型: BOOL

公式ドキュメント

最大 8 個のサブオーソリティを持つセキュリティ識別子 (SID) を割り当てて初期化します。

戻り値

関数が成功した場合、戻り値は 0 以外の値です。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、 GetLastError を呼び出します。

解説(Remarks)

AllocateAndInitializeSid 関数で割り当てた SID は、FreeSid 関数を使用して解放する必要があります。

この関数は 32 ビットの RID 値を持つ SID を作成します。より長い RID 値を必要とするアプリケーションでは、 CreateWellKnownSid を使用してください。

例

この関数を使用する例については、Creating a Security Descriptor for a New Object または Taking Object Ownership を参照してください。

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

各言語での呼び出し定義

// 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 <MarshalAs(UnmanagedType.Bool)> 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(変数))。