AtlGetSacl

指定されたオブジェクトのシステム アクセス制御リスト (SACL: System Access Control List) の情報を取得します。

重要 : 重要

この関数は Windows ランタイムで実行されるアプリケーションで使用することはできません。

inline bool AtlGetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
CSacl* pSacl,
bool bRequestNeededPrivileges= true
) throw(...);

パラメーター

  • hObject
    セキュリティ情報を取得するオブジェクトへのハンドル。

  • ObjectType
    hObject のパラメーターで識別されるオブジェクトの型を示す SE_OBJECT_TYPE の列挙体からの値を指定します。

  • pSacl
    取得したセキュリティ情報を含む SACL オブジェクトへのポインター。

  • bRequestNeededPrivileges
    true の場合、関数は SE_SECURITY_NAME 特権を有効にすると、コンプリートそれを復元します。

戻り値

false エラーが正常に true を返します。

解説

AtlGetSacl が何度も多くの異なるオブジェクトに呼び出されるの場合は、false に設定 bRequestNeededPrivileges が関数を呼び出す前に SE_SECURITY_NAME 特権を一度有効にする方が効率的です。

必要条件

ヘッダー : atlsecurity.h

参照

関連項目

AtlSetSacl

CSacl クラス

その他の技術情報

セキュリティに関するグローバル関数