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

Artigo
02/23/2024

O método LookupSids retorna os nomes comuns correspondentes a cada um dos elementos na lista especificada de SIDs.

Sintaxe

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

Parâmetros

[in] cSids

O número de ponteiros para estruturas sid apontados por rgpSids.

[in] rgpSids

Um ponteiro para uma matriz de ponteiros para estruturas sid .

[out] ppdo

Um ponteiro para um ponteiro para um objeto de transferência de dados retornado que contém os nomes comuns dos SIDs. Opcionalmente, esse parâmetro também retorna o NOME UPN dos SIDs no parâmetro rgpSids . O objeto de transferência de dados é uma estrutura SID_INFO .

Retornar valor

Retorna S_OK se tiver êxito.

Retorna um código de erro diferente de zero se ocorrer um erro.

Comentários

Sua implementação de LookupSids poderá retornar E_NOTIMPL se o editor de controle de acesso for determinar os nomes comuns correspondentes aos SIDs especificados. No entanto, se o editor de controle de acesso receber qualquer código de retorno diferente de S_OK, o editor determinará essas informações.

O cliente deve retornar os nomes comuns por meio do objeto de dados usando o formato a seguir.

#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	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	aclui.h