ISecurityInformation2::LookupSids-Methode (aclui.h)

Artikel
02/26/2024

Die LookupSids-Methode gibt die allgemeinen Namen zurück, die den einzelnen Elementen in der angegebenen Liste der SIDs entsprechen.

Syntax

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

Parameter

[in] cSids

Die Anzahl der Zeiger auf SID-Strukturen , auf die von rgpSids verwiesen wird.

[in] rgpSids

Ein Zeiger auf ein Array von Zeigern auf SID-Strukturen .

[out] ppdo

Ein Zeiger auf einen Zeiger auf ein zurückgegebenes Datenübertragungsobjekt, das die allgemeinen Namen der SIDs enthält. Optional gibt dieser Parameter auch den Benutzerprinzipalnamen (User Principal Name, UPN) der SIDs im rgpSids-Parameter zurück. Das Datenübertragungsobjekt ist eine SID_INFO-Struktur .

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück.

Gibt einen fehlerfreien Fehlercode zurück, wenn ein Fehler auftritt.

Hinweise

Ihre Implementierung von LookupSids kann E_NOTIMPL zurückgeben, wenn der Zugriffssteuerungs-Editor die allgemeinen Namen ermitteln soll, die den angegebenen SIDs entsprechen. Wenn der Zugriffssteuerungs-Editor jedoch einen anderen Rückgabecode als S_OK empfängt, bestimmt der Editor diese Informationen.

Der Client muss die allgemeinen Namen über das Datenobjekt im folgenden Format zurückgeben.

#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;

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	aclui.h