AtlGetSacl
更新 : 2007 年 11 月
指定されたオブジェクトのシステム アクセス制御リスト (SACL: System Access Control List) の情報を取得します。
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 権限を有効にし、操作の完了時に元に戻します。
戻り値
正常に終了した場合は true を返します。それ以外の場合は false を返します。
解説
AtlGetSacl を多数の異なるオブジェクトで何度も呼び出す場合は、bRequestNeededPrivileges を false に設定し、この関数を呼び出す前に SE_SECURITY_NAME 権限を有効にした方がより効率的です。
必要条件
ヘッダー : atlsecurity.h