<Return[I]><Top>

InitializeSid

Declare Function Api_InitializeSid& Lib "advapi32" Alias "InitializeSid" (Sid As Any, pIdentifierAuthority As SID_IDENTIFIER_AUTHORITY, ByVal nSubAuthorityCount As Byte)

Declare Function InitializeSid Lib "advapi32" Alias "InitializeSid" (Sid As Any, pIdentifierAuthority As SID_IDENTIFIER_AUTHORITY, ByVal nSubAuthorityCount As Byte) As Long

SID 構造体を初期化する。SID はセキュリティ ID を表す。

パラメータ
Sid
    初期化したい SID 構造体へのポインタを指定する。
pIdentifierAuthority
    SID 構造体内に設定されている SID_IDENTIFIER_AUTHORITY 構造体へのポインタを指定する。
nSubAuthorityCount
    SID 内の副権限の数を指定する。副権限の値は個別に設定しなければならない。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    InitializeSid 関数は SID に関連する副権限の数を設定するが、副権限の値は設定しない。その場合、GetSidSubAuthority などの関数

    を使って、値を個別に設定する必要がある。
    AllocateAndInitializeSid 関数を使うと、SID を初期化し、その中の副権限の値を設定できる。