Méthode ISecurityInformation2 ::LookupSids (aclui.h)
La méthode LookupSids retourne les noms communs correspondant à chacun des éléments de la liste spécifiée de SID.
Syntaxe
HRESULT LookupSids(
[in] ULONG cSids,
[in] PSID *rgpSids,
[out] LPDATAOBJECT *ppdo
);
Paramètres
[in] cSids
Nombre de pointeurs vers des structures SID pointées vers des rgpSids.
[in] rgpSids
Pointeur vers un tableau de pointeurs vers des structures SID .
[out] ppdo
Pointeur vers un pointeur vers un objet de transfert de données retourné qui contient les noms courants des SID. Éventuellement, ce paramètre retourne également le nom d’utilisateur principal (UPN) des SID dans le paramètre rgpSids . L’objet de transfert de données est une structure SID_INFO .
Valeur retournée
Retourne S_OK en cas de réussite.
Retourne un code d’erreur différent de zéro si une erreur se produit.
Remarques
Votre implémentation de LookupSids peut retourner E_NOTIMPL si l’éditeur de contrôle d’accès doit déterminer les noms communs correspondant aux SID spécifiés. Toutefois, si l’éditeur de contrôle d’accès reçoit un code de retour autre que S_OK, l’éditeur détermine ces informations.
Le client doit retourner les noms courants via l’objet de données au format suivant.
#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;
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | aclui.h |