Fungsi PSRegisterPropertySchema (propsys.h)

Artikel
08/25/2023

Menginformasikan subsistem skema tentang penambahan file skema deskripsi properti.

Sintaks

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Parameter

[in] pszPath

Jenis: PCWSTR

Arahkan ke jalur file lengkap, sebagai string Unicode, ke file skema deskripsi properti (.propdesc) pada komputer lokal. Ini dapat berupa jalur lengkap yang sepenuhnya ditentukan, atau jalur lengkap yang mencakup variabel lingkungan seperti %PROGRAMFILES%.

Nilai kembali

Jenis: HRESULT

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Semua deskripsi properti dalam skema didaftarkan.
E_ACCESSDENIED	Konteks panggilan tidak memiliki hak istimewa yang tepat.
INPLACE_S_TRUNCATED	Satu atau beberapa deskripsi properti dalam skema gagal mendaftar. Kegagalan tertentu dicatat dalam log peristiwa aplikasi.

Keterangan

Fungsi ini adalah API pembungkus untuk implementasi subsistem skema IPropertySystem::RegisterPropertySchema. Panggil fungsi ini hanya ketika file pertama kali diinstal pada komputer. Biasanya, aplikasi penyiapan memanggil fungsi ini setelah menginstal file .propdesc, yang harus disimpan di direktori penginstalan aplikasi di bawah Program Files. Beberapa panggilan dapat dilakukan ke IPropertySystem::RegisterPropertySchema untuk mendaftarkan beberapa file skema.

Saat mendaftarkan file skema properti, ingatlah bahwa mereka dapat dibaca oleh proses yang berjalan sebagai pengguna yang berbeda. Oleh karena itu, penting untuk menempatkan file skema di lokasi yang memberikan akses baca ke semua pengguna di komputer. Demikian pula, gunakan jalur absolut ke file dalam parameter pszPath fungsi ini.

Catatan Karena skema khusus untuk komputer dan tidak dapat didaftarkan untuk setiap pengguna individu, mendaftarkan jalur file di bawah profil pengguna tidak didukung pada Windows Vista.

Jika kegagalan penuh atau parsial ditemui yang mencegah deskripsi properti dimuat, penyebabnya dicatat dalam log peristiwa aplikasi. Fungsi ini gagal dengan E_ACCESSDENIED jika konteks panggilan tidak memiliki hak istimewa yang tepat, yang mencakup akses tulis ke HKEY_LOCAL_MACHINE. Merupakan tanggung jawab aplikasi panggilan untuk mendapatkan hak istimewa melalui mekanisme Kontrol Akun Pengguna (UAC).

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	propsys.h
Pustaka	Propsys.lib
DLL	Propsys.dll (versi 5.0 atau yang lebih baru)
Redistribusi	Windows Desktop Search (WDS) 3.0

Bagikan melalui