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

[アーティクル]
02/23/2024

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