InitializeAcl

新しい ACL 構造体を初期化する。

InitializeAcl pAcl, nAclLength, dwAclRevision

pAcl : [var] この関数で初期化する ACL 構造体へのポインタ。この関数を呼び出す前に pAcl のメモリを確保すること。
nAclLength : [int] pAcl パラメータが指すバッファの長さをバイト単位で指定する。この値は ACL ヘッダーと、ACL に格納されるすべての ACE を含むのに十分な大きさである必要がある。さらに、この値は DWORD 境界に整列する必要がある。ACL のサイズ計算の詳細については「備考」を参照。
dwAclRevision : [int] 作成する ACL 構造体のリビジョンレベル。

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

解説

新しい ACL 構造体を初期化する。

[戻り値]
関数が成功した場合、0 以外を返す。
関数が失敗した場合、0 を返す。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
InitializeAcl 関数は空の ACL 構造体を作成する。ACL には ACE が含まれていない。空の ACL
をオブジェクトに適用すると、そのオブジェクトへのすべてのアクセスが拒否される。ACL の初期サイズは、使用前に ACL に追加する予定の
ACE の数に依存する。例えば、ACL にユーザーとグループの ACE を含める予定であれば、2 つの ACE に基づいて ACL
を初期化する。既存の ACL の変更については「Modifying the ACLs of an Object」を参照。ACL
の初期サイズを計算するには、以下を合計し、最も近い DWORD に整列する。
（以下省略）

情報