Méthode ISecurityInformation2 ::LookupSids (aclui.h)

Article
02/26/2024

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