Metodo ISecurityInformation2::LookupSids (aclui.h)

Articolo
02/23/2024

Il metodo LookupSids restituisce i nomi comuni corrispondenti a ognuno degli elementi nell'elenco specificato di SID.

Sintassi

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

Parametri

[in] cSids

Numero di puntatori alle strutture SID a cui punta rgpSids.

[in] rgpSids

Puntatore a una matrice di puntatori alle strutture SID .

[out] ppdo

Puntatore a un puntatore a un oggetto di trasferimento dati restituito che contiene i nomi comuni dei SID. Facoltativamente, questo parametro restituisce anche il nome dell'entità utente (UPN) dei SID nel parametro rgpSids . L'oggetto trasferimento dati è una struttura SID_INFO .

Valore restituito

Restituisce S_OK in caso di esito positivo.

Restituisce un codice di errore diverso da zero se si verifica un errore.

Commenti

L'implementazione di LookupSids può restituire E_NOTIMPL se l'editor di controllo di accesso consiste nel determinare i nomi comuni corrispondenti ai SID specificati. Tuttavia, se l'editor di controllo di accesso riceve codice restituito diverso da S_OK, l'editor determina queste informazioni.

Il client deve restituire i nomi comuni tramite l'oggetto dati usando il formato seguente.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	aclui.h