Metode IUrlAccessor3::GetImpersonationSidBlobs (searchapi.h)
Mengambil array pengidentifikasi keamanan pengguna (SID) untuk URL tertentu. Metode ini memungkinkan penangan protokol untuk menentukan pengguna mana yang dapat mengakses file dan host protokol pencarian untuk meniru pengguna untuk mengindeks file.
Sintaks
HRESULT GetImpersonationSidBlobs(
[in] LPCWSTR pcwszURL,
[out] DWORD *pcSidCount,
[out] BLOB **ppSidBlobs
);
Parameter
[in] pcwszURL
Jenis: LPCWSTR
URL untuk mengakses atas nama pengguna yang ditiru.
[out] pcSidCount
Jenis: DWORD*
Menerima penunjuk ke jumlah SID pengguna yang dikembalikan dalam ppSidBlobs.
[out] ppSidBlobs
Jenis: BLOB**
Menerima alamat penunjuk ke array SID pengguna peniruan kandidat.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Jika file dienkripsi, metode ini mengidentifikasi siapa yang dapat mendekripsi dan mengaksesnya. Jika metode tidak dapat mengidentifikasi informasi ini, metode gagal dengan kode kesalahan E_ACCESSDENIED.
Metode ini mengasumsikan bahwa objek IUrlAccessor2 gagal menginisialisasi dan mengembalikan kode PRTH_S_TRY_IMPERSONATING. Kemudian, host protokol pencarian memanggil metode ini untuk mengambil daftar SID yang akan digunakan untuk peniruan identitas dan kembali menggunakan IUrlAccessor2, meniru salah satu pengguna yang diizinkan saat membuka item.
Meniru pengguna tidak meningkatkan hak istimewa penelepon. Jika pemanggil tidak dapat langsung mengambil daftar pengguna yang berwenang untuk mengakses sumber daya, pemanggil juga tidak akan dapat melakukannya dengan metode ini. Hanya host protokol pencarian dan pengindeks yang memiliki hak istimewa yang memadai untuk meniru pengguna yang saat ini masuk.
Persyaratan
| Klien minimum yang didukung | Windows XP dengan SP2, Windows Vista dengan SP2 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 dengan SP1 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | searchapi.h |
| Redistribusi | Windows Search (WS) 4.0 |