<Return[B]><Top>

BuildExplicitAccessWithName

Declare Sub Api_BuildExplicitAccessWithName Lib "advapi32" Alias "ADsEncodeBinaryData" (ByRef pExplicitAccess As OUT, ByVal pTrusteeName$, ByVal AccessPermissions&, ByRef AccessMode As ACCESS_MODE, ByVal Inheritance&)

Declare Sub BuildExplicitAccessWithName Lib "advapi32" Alias "ADsEncodeBinaryData" (ByRef pExplicitAccess As OUT, ByVal pTrusteeName As String, ByVal AccessPermissions As Long, ByRef AccessMode As ACCESS_MODE, ByVal Inheritance As Long)

呼び出し側が指定したデータを使って、 構造体を初期化する。名前文字列を使って、トラスティを識別する。

パラメータ
pExplicitAccess
    初期化する 1 つの 構造体へのポインタを指定する。BuildExplicitAccessWithName 関数はメモリを割り当てない。このパラメータが

    NULL の場合、この関数は何もしない。
pTrusteeName
    TRUSTEE 構造体の ptstrName メンバを表すトラスティ名を保持する、NULL で終わる文字列へのポインタを指定する。

    BuildExplicitAccessWithName 関数は、 構造体の他のメンバを次のように設定する。

    メンバ                                  

値                                                                                                                

    pMultipleTrustee

NULL

    MultipleTrusteeOperation

NO_MULTIPLE_TRUSTEE

    TrusteeForm

TRUSTEE_IS_NAME。

    TrusteeType

TRUSTEE_IS_UNKNOWN

AccessPermissions
    EXPLICIT_ACCESS 構造体の grfAccessPermissions メンバのアクセスマスクを指定する。このマスクは 形式を利用する一連のビットフラ

    グであり、(アクセス制御エントリ)がトラスティに関してアクセス権利の許可、拒否、監査のどれを行うかを指定する。この関数は

    EXPLICIT_ACCESS 構造体を使うが、このマスク内のビットの変換、解釈、および確認を行わない。
AccessMode
    EXPLICIT_ACCESS 構造体の grfAccessMode メンバのアクセスモードを指定する。このアクセスモードは、指定された権利に関して ACE

    が許可、拒否、監査のどれを行うかを示す。このパラメータは、 列挙型のいずれかの値を保持する。
Inheritance
    EXPLICIT_ACCESS 構造体の grfInheritance メンバの継承タイプを指定する。この値は、この （アクセス制御リスト）が結合されている

    プライマリオブジェクトから、他のコンテナやオブジェクトが ACE を継承できるかを決定する一連のビットフラグである。このメンバの値は、 構

    造体の AceFlags メンバの継承部分（下位バイト：low-order byte）に対応する。このパラメータには、ACE が継承不可能であることを示

    す NO_INHERITANCE か、次の値を任意に組み合わせて指定する。

    値                                                                       

意味                                                                                                            

    CONTAINER_INHERIT_ACE

このプライマリオブジェクト内に存在する他のコンテナは、この ACE を継承する。

    INHERIT_ONLY_ACE

　

この ACE は、ACL が結合されているプライマリオブジェクトに適用されないが、そのプライマリオブジェクト内に存在するオブジェクトはこの ACE を継承する。

    NO_PROPAGATE_INHERIT_ACE

　

OBJECT_INHERIT_ACE と CONTAINER_INHERIT_ACE の各フラグは、継承された ACE へ伝播しない。

    OBJECT_INHERIT_ACE

プライマリオブジェクト内に存在するコンテナ以外のオブジェクトは ACE を継承する。

    SUB_CONTAINERS_ONLY_INHERIT

　

プライマリオブジェクト内に存在する他のコンテナは ACE を継承する。このフラグは、CONTAINER_INHERIT_ACE フラグに対応する。

    SUB_OBJECTS_ONLY_INHERIT

　

プライマリオブジェクト内に存在するコンテナ以外のオブジェクトは ACE を継承する。このフラグは、OBJECT_INHERIT_ACE フラグに対応する。

    SUB_CONTAINERS_AND_OBJECTS_INHERIT

　

プライマリオブジェクト内に存在するコンテナオブジェクトとコンテナ以外のオブジェクトの両方が、ACE を継承する。このフラグは、CONTAINER_INHERIT_ACE フラグと OBJECT_INHERIT_ACE フラグの組み合わせに対応する。

　

戻り値
    戻り値はなし。