ISecurityInformation2::LookupSids-Methode (aclui.h)
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 |