次の方法で共有


ISecurityInformation2::LookupSids メソッド (aclui.h)

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

構文

HRESULT LookupSids(
  [in]  ULONG        cSids,
  [in]  PSID         *rgpSids,
  [out] LPDATAOBJECT *ppdo
);

パラメーター

[in] cSids

rgpSids によって指される SID 構造体へのポインターの数。

[in] rgpSids

SID 構造体へのポインターの配列へのポインター。

[out] ppdo

SID の共通名を含む、返されるデータ転送オブジェクトへのポインターへのポインター。 必要に応じて、このパラメーターは rgpSids パラメーター内の SID のユーザー プリンシパル名 (UPN) も返します。 データ転送オブジェクトは 、SID_INFO 構造です。

戻り値

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

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

注釈

LookupSids の実装では、アクセス制御エディターが指定した SID に対応する共通名を決定する場合に、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;

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー aclui.h

こちらもご覧ください

Access Control エディター

Access Control エディター関数

ISecurityInformation2

SID

SID_INFO

SID_INFO_LIST