ISecurityInformation2

アクセス制御エディターが、ISecurityInformation インターフェイスでは提供されない情報をクライアントから取得できるようにします。

IsDaclCanonical メソッドは、指定した DACL 構造体に含まれる ACE が、クライアントが実装する DACL の並び順の定義に従って並んでいるかどうかを判定します。

指定した DACL 構造体に含まれる ACE が、クライアントが実装する DACL の並び順の定義に従って並んでいる場合は TRUE を返します。

ACE が正しく並んでいない場合は FALSE を返します。

このメソッドの戻り値が FALSE の場合、アクセス制御エディターは、DACL の並び順が正しくない旨を示すメッセージ ボックスを表示します。このメソッドが提供されておらず、かつエディターがこの情報を必要とする場合、エディターは Order of ACEs in a DACL で定義された正規の並び順を確認します。

LookupSids メソッドは、指定した SID のリストの各要素に対応する共通名 (common name) を返します。

成功した場合は S_OK を返します。

エラーが発生した場合は 0 以外のエラー コードを返します。

アクセス制御エディターに、指定した SID に対応する共通名を判定させる場合、LookupSids の実装は E_NOTIMPL を返すことができます。ただし、アクセス制御エディターが S_OK 以外の戻り値を受け取った場合は、エディターがこの情報を判定します。

クライアントは、次の形式を使用してデータ オブジェクトを通じて共通名を返す必要があります。

#include <windows.h>

// HGLOBAL containing SID_INFO_LIST returned by
// ISecurityInformation2::LookupSids
#define CFSTR_ACLUI_SID_INFO_LIST   TEXT("CFSTR_ACLUI_SID_INFO_LIST")

// Data structures corresponding to CFSTR_ACLUI_SID_INFO_LIST
typedef struct _SID_INFO
{
    PSID    pSid;
    PWSTR   pwzCommonName;
    PWSTR   pwzClass;       // Used for selecting icon, for example,
                            // "User" or "Group"
    PWSTR   pwzUPN;         // Optional pointer to a user principal
                            // name
} SID_INFO, *PSID_INFO;

typedef struct _SID_INFO_LIST
{
    ULONG       cItems;
    SID_INFO    aSidInfo[ANYSIZE_ARRAY];
} SID_INFO_LIST, *PSID_INFO_LIST;