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

Artículo
02/26/2024

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