AtlGetSecurityDescriptor

更新 : 2007 年 11 月

指定されたオブジェクトのセキュリティ記述子を取得します。

inline bool AtlGetSecurityDescriptor(
   LPCTSTR pszObjectName,
   SE_OBJECT_TYPE ObjectType,
   CSecurityDesc * pSecurityDescriptor,
   SECURITY_INFORMATION requestedInfo = OWNER_SECURITY_INFORMATION | 
      GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION | 
      SACL_SECURITY_INFORMATION,
   bool bRequestNeededPrivileges = true
) throw(...);

パラメータ

  • pszObjectName
    セキュリティ情報を取得するオブジェクトの名前を指定する null で終わる文字列へのポインタ。

  • ObjectType
    pszObjectName パラメータによって識別されるオブジェクトの型を示す SE_OBJECT_TYPE 列挙型からの値。

  • pSecurityDescriptor
    要求したセキュリティ記述子を受け取るオブジェクト。

  • requestedInfo
    取得するセキュリティ情報の型を示す SECURITY_INFORMATION ビット フラグのセット。このパラメータには、次の値を組み合わせて指定できます。

  • bRequestNeededPrivileges
    true を指定した場合、この関数は SE_SECURITY_NAME 権限を有効にし、操作の完了時に元に戻します。

戻り値

正常に終了した場合は true を返します。それ以外の場合は false を返します。

解説

AtlGetSecurityDescriptor を多数の異なるオブジェクトで何度も呼び出す場合は、bRequestNeededPrivileges を false に設定し、この関数を呼び出す前に SE_SECURITY_NAME 権限を有効にした方がより効率的です。

必要条件

ヘッダー : atlsecurity.h

参照

その他の技術情報

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