Método ISecurityInformation2::LookupSids (aclui.h)
El método LookupSids devuelve los nombres comunes correspondientes a cada uno de los elementos de la lista especificada de SID.
Sintaxis
HRESULT LookupSids(
[in] ULONG cSids,
[in] PSID *rgpSids,
[out] LPDATAOBJECT *ppdo
);
Parámetros
[in] cSids
Número de punteros a estructuras SID a las que apunta rgpSids.
[in] rgpSids
Puntero a una matriz de punteros a estructuras SID .
[out] ppdo
Puntero a un puntero a un objeto de transferencia de datos devuelto que contiene los nombres comunes de los SID. Opcionalmente, este parámetro también devuelve el nombre principal de usuario (UPN) de los SID en el parámetro rgpSids . El objeto de transferencia de datos es una estructura SID_INFO .
Valor devuelto
Devuelve S_OK si se ejecuta correctamente.
Devuelve un código de error distinto de cero si se produce un error.
Comentarios
La implementación de LookupSids puede devolver E_NOTIMPL si el editor de control de acceso es determinar los nombres comunes correspondientes a los SID especificados. Sin embargo, si el editor de control de acceso recibe cualquier código de retorno distinto de S_OK, el editor determina esta información.
El cliente debe devolver los nombres comunes a través del objeto de datos con el formato siguiente.
#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;
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | aclui.h |