Metode ISecurityInformation2::LookupSids (aclui.h)

Artikel
02/26/2024

Metode LookupSids mengembalikan nama umum yang sesuai dengan setiap elemen dalam daftar SID yang ditentukan.

Sintaks

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

Parameter

[in] cSids

Jumlah pointer ke struktur SID yang ditujukkan oleh rgpSids.

[in] rgpSids

Penunjuk ke array pointer ke struktur SID .

[out] ppdo

Penunjuk ke penunjuk ke objek transfer data yang dikembalikan yang berisi nama umum SID. Secara opsional, parameter ini juga mengembalikan nama prinsipal pengguna (UPN) dari SID dalam parameter rgpSids . Objek transfer data adalah struktur SID_INFO .

Menampilkan nilai

Mengembalikan S_OK jika berhasil.

Mengembalikan kode kesalahan bukan nol jika terjadi kesalahan.

Keterangan

Implementasi LookupSids Anda dapat mengembalikan E_NOTIMPL jika editor kontrol akses adalah untuk menentukan nama umum yang sesuai dengan SID yang ditentukan. Namun, jika editor kontrol akses menerima kode pengembalian selain S_OK, editor menentukan informasi ini.

Klien harus mengembalikan nama umum melalui objek data menggunakan format berikut.

#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;

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	aclui.h