Метод ISecurityInformation2::LookupSids (aclui.h)

Статья
02/23/2024

Метод LookupSids возвращает общие имена, соответствующие каждому из элементов в указанном списке идентификаторов БЕЗОПАСНОСТИ.

Синтаксис

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

Параметры

[in] cSids

Количество указателей на структуры ИД безопасности , на которые указывают rgpSids.

[in] rgpSids

Указатель на массив указателей на структуры SID .

[out] ppdo

Указатель на указатель на возвращаемый объект передачи данных, содержащий общие имена идентификаторов безопасности. При необходимости этот параметр также возвращает имя участника-пользователя (UPN) идентификаторов БЕЗОПАСНОСТИ в параметре rgpSids . Объект передачи данных является SID_INFO структурой.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK.

При возникновении ошибки возвращает ненулевой код ошибки.

Реализация 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;

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	aclui.h