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