Bagikan melalui


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

Lihat juga

IUrlAccessor3

IUrlAccessor4

Pesan Kesalahan Penangan Protokol Pencarian