BuildExplicitAccessWithNameW

呼び出し側が指定したデータで EXPLICIT_ACCESS 構造体を初期化する。トラスティは名前文字列で識別される。(Unicode)

BuildExplicitAccessWithNameW pExplicitAccess, pTrusteeName, AccessPermissions, AccessMode, Inheritance

pExplicitAccess : [var] 初期化する EXPLICIT_ACCESS 構造体へのポインタ。BuildExplicitAccessWithName 関数はメモリを一切確保しない。このパラメータを NULL にすることはできない。
pTrusteeName : [wstr] TRUSTEE 構造体の ptstrName メンバに対するトラスティの名前を含む null 終端文字列へのポインタ。BuildExplicitAccessWithName 関数は TRUSTEE 構造体の他のメンバを以下のように設定する。
AccessPermissions : [int] EXPLICIT_ACCESS 構造体の grfAccessPermissions メンバに対するアクセスマスクを指定する。マスクは ACCESS_MASK 形式を使用するビットフラグのセットで、ACE がトラスティに対して許可、拒否、または監査するアクセス権を指定する。EXPLICIT_ACCESS 構造体を使用する関数は、このマスク内のビットを変換、解釈、検証しない。
AccessMode : [int] EXPLICIT_ACCESS 構造体の grfAccessMode メンバに対するアクセスモードを指定する。アクセスモードは、ACE が指定した権限を許可、拒否、または監査するかを示す。DACL の場合、このパラメータには ACCESS_MODE 列挙型の値のいずれかを指定できる。SACL の場合、このパラメータには ACCESS_MODE 値の組み合わせを指定できる。
Inheritance : [int] EXPLICIT_ACCESS 構造体の grfInheritance メンバに対する継承型を指定する。この値は、他のコンテナやオブジェクトが、ACL がアタッチされているプライマリオブジェクトから ACE を継承できるかどうかを決定するビットフラグのセットである。このメンバの値は AceFlags メンバの継承部分（下位バイト）に対応する。

(プラグイン / モジュール : advapi32.dll)

解説

呼び出し側が指定したデータで EXPLICIT_ACCESS 構造体を初期化する。トラスティは名前文字列で識別される。(Unicode)

[備考]
> [!NOTE] > aclapi.h ヘッダは、BuildExplicitAccessWithName を UNICODE
プリプロセッサ定数の定義に基づいて ANSI 版または Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報