GetInheritanceSourceW

アクセス制御リスト (ACL) 内の継承されたアクセス制御エントリ (ACE) のソースに関する情報を返す。(Unicode)

GetInheritanceSourceW pObjectName, ObjectType, SecurityInfo, Container, pObjectClassGuids, GuidCount, pAcl, pfnArray, pGenericMapping, pInheritArray

pObjectName : [wstr] チェックする ACL を使用するオブジェクトの名前へのポインタ。
ObjectType : [int] pObjectName が示すオブジェクトの型。指定可能な値は SE_FILE_OBJECT、SE_REGISTRY_KEY、SE_DS_OBJECT、SE_DS_OBJECT_ALL。
SecurityInfo : [int] オブジェクトで使用される ACL の種類。指定可能な値は DACL_SECURITY_INFORMATION または SACL_SECURITY_INFORMATION。
Container : [int] オブジェクトがコンテナ オブジェクトの場合は TRUE、リーフ オブジェクトの場合は FALSE。唯一のリーフ オブジェクトは SE_FILE_OBJECT である点に注意する。
pObjectClassGuids : [var] pObjectName に関連付けられたオブジェクトの型または名前を識別する GUID のオプションの一覧。オブジェクト マネージャが 1 つのオブジェクト クラスのみをサポートする場合、またはオブジェクト クラスに関連付けられた GUID を持たない場合、これは NULL でもよい。
GuidCount : [int] pObjectClassGuids が指す GUID の数。
pAcl : [var] オブジェクトの ACL。
pfnArray : [var] 予約済み。このパラメータは NULL に設定する。
pGenericMapping : [var] オブジェクトに対する汎用権限から特定権限へのマッピング。
pInheritArray : [var] GetInheritanceSource 関数が継承情報を入れる INHERITED_FROM 構造体の配列へのポインタ。呼び出し側は ACL 内の各 ACE 用のエントリに十分なメモリを割り当てなければならない。

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

解説

アクセス制御リスト (ACL) 内の継承されたアクセス制御エントリ (ACE) のソースに関する情報を返す。(Unicode)

[戻り値]
関数が成功した場合、ERROR_SUCCESS を返す。失敗した場合、WinError.h で定義されるゼロ以外のエラーコードを返す。

[備考]
GetInheritanceSource 関数は、INHERITED_FROM
構造体で返される名前のためにメモリを割り当てる。関数がこのメモリの使用を終えたら、呼び出し元プログラムは
FreeInheritedFromArray
を呼び出してそれを解放しなければならない。呼び出し側は配列自体のメモリを提供する必要がある点に注意する。呼び出し側がそのメモリを割り当てた場合、呼び出し側は
FreeInheritedFromArray
を呼び出した後にそのメモリを解放しなければならない。この関数は競合状態を処理しない。スレッドがこの関数を呼び出したのとほぼ同じ時刻に別のスレッドがオブジェクトのセキュリティ記述子を変更した場合、この関数は失敗する可能性がある。
> [!NOTE] > aclapi.h ヘッダーは GetInheritanceSource
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode
版を自動的に選択する。エンコーディングに依存しないエイリアスと、エンコーディングに依存しないコードとを混在させると、コンパイルエラーや実行時エラーを引き起こす不整合が生じる可能性がある。詳細は
[関数プロトタイプの規約](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報