BuildTrusteeWithObjectsAndNameW

オブジェクト固有のアクセス制御エントリ (ACE) 情報を用いて TRUSTEE 構造体を初期化し、構造体の残りのメンバを既定値に初期化する。呼び出し側はトラスティの名前も指定する。(Unicode)

BuildTrusteeWithObjectsAndNameW pTrustee, pObjName, ObjectType, ObjectTypeName, InheritedObjectTypeName, Name

pTrustee : [var] 本関数によって初期化される TRUSTEE 構造体へのポインタ。このパラメータの値が NULL か有効でないポインタの場合、結果は不定となる。
pObjName : [var] トラスティとセキュリティ保護可能オブジェクトに関する情報を含む OBJECTS_AND_NAME 構造体へのポインタ。
ObjectType : [int] セキュリティ保護可能オブジェクトの種類に関する情報を含む SE_OBJECT_TYPE 列挙体へのポインタ。
ObjectTypeName : [wstr] pTrustee パラメータで返される TRUSTEE 構造体に追加する ObjectType GUID に対応する名前を指定する文字列へのポインタ。本関数は、この名前に対応する ObjectType GUID を決定する。
InheritedObjectTypeName : [wstr] pTrustee パラメータで返される TRUSTEE 構造体に追加する InheritedObjectType GUID に対応する名前を指定する文字列へのポインタ。本関数は、この名前に対応する InheritedObjectType GUID を決定する。
Name : [wstr] トラスティを識別するために使用される名前を指定する文字列へのポインタ。

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

解説

オブジェクト固有のアクセス制御エントリ (ACE) 情報を用いて TRUSTEE
構造体を初期化し、構造体の残りのメンバを既定値に初期化する。呼び出し側はトラスティの名前も指定する。(Unicode)

[備考]
本関数は TRUSTEE 構造体や OBJECTS_AND_NAME 構造体のためのメモリを確保しない。オブジェクト固有 ACE
の詳細については「Object-specific ACEs」を参照のこと。
> [!NOTE] > aclapi.h ヘッダは、BuildTrusteeWithObjectsAndName を UNICODE
プリプロセッサ定数の定義に基づいて ANSI 版または Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報