Metode IUrlAccessor::GetSecurityDescriptor (searchapi.h)

Artikel
03/04/2024

Mendapatkan pendeskripsi keamanan untuk item URL. Keamanan diterapkan pada waktu kueri, sehingga deskriptor ini mengidentifikasi keamanan untuk akses baca.

Sintaks

HRESULT GetSecurityDescriptor(
  [out] BYTE  *pSD,
  [in]  DWORD dwSize,
  [out] DWORD *pdwLength
);

Parameter

[out] pSD

Jenis: BYTE*

Menerima penunjuk ke deskriptor keamanan.

[in] dwSize

Jenis: DWORD

Ukuran dalam TCHARdari array pSD .

[out] pdwLength

Jenis: DWORD*

Menerima pointer ke jumlah TCHARyang ditulis ke pSD, tidak termasuk NULL yang mengakhiri.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini memungkinkan pemetaan kustom antara pengguna yang terdaftar ke sumber konten dan pengguna yang terdaftar di domain, jika mereka berbeda. Deskriptor keamanan yang dibuat dalam metode ini harus relatif sendiri.

Jika URL berisi pengidentifikasi keamanan pengguna (SID), maka penangan protokol dipanggil dalam konteks keamanan pengguna tersebut, dan metode ini harus mengembalikan E_NOTIMPL.

Jika URL tidak berisi SID pengguna, maka handler protokol dipanggil dalam konteks keamanan layanan sistem. Dalam hal ini, metode ini dapat mengembalikan daftar kontrol akses (ACL) untuk membatasi akses baca, atau PRTH_S_ACL_IS_READ_EVERYONE untuk memungkinkan siapa pun membaca akses selama kueri.

Catatan Jika metode ini mengembalikan E_NOTIMPL dan URL TIDAK berisi SID pengguna, maka item dapat diambil oleh semua kueri pengguna.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	searchapi.h
Redistribusi	Windows Desktop Search (WDS) 3.0

Lihat juga

IUrlAccessor

Pesan Kesalahan Handler Protokol Pencarian

Bagikan melalui