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 |