Metode ISecurityInformation2::LookupSids (aclui.h)
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk