<Return[D]><Top>

DeleteAce

Declare Function Api_DeleteAce& Lib "advapi32" Alias "DeleteAce" (pAcl As ACL, ByVal dwAceIndex&)

Declare Function DeleteAce Lib "advapi32" Alias "DeleteAce" (pAcl As ACL, ByVal dwAceIndex As Long) As Long

ACL(アクセス制御リスト)から ACE(アクセス制御エントリ)を削除する。
ACE は、access-control entry の略称。ACL は、access-control list の略称。

パラメータ
pAcl
    1 つの 構造体へのポインタを指定する。dwAceIndex パラメータで指定された ACE をこの ACL から削除する。
dwAceIndex
    削除する ACE を指定する。値 0 は ACL 内の最初の ACE に、値 1 は 2 番目の ACE に対応する。以下同様。

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

解説
    アプリケーションでは、GetAclInformation 関数で取得した 構造体を使って、ACL のサイズと、その中の ACE の数を把握できる。

    GetAce 関数は、個別の ACE に関する情報を取得する。