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