Share via

Metode ISettingsItem::CreateSettingByPath (wcmconfig.h)

  • Artikel

Membuat objek pengaturan yang ditentukan oleh jalur.

Sintaks

HRESULT CreateSettingByPath(
  [in]  const WCHAR   *Path,
  [out] ISettingsItem **Setting
);

Parameter

[in] Path

Penunjuk ke jalur.

[out] Setting

Penunjuk ke item ISettingsItem yang baru dibuat.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Menunjukkan keberhasilan.
WCM_E_STATENODENOTFOUND
 Menunjukkan bahwa metode dipanggil untuk membuat item yang bukan elemen daftar atau belum ada.
WCM_E_READONLYITEM
 Menunjukkan bahwa item tidak dapat ditulis, seperti jika itu adalah item baca-saja, atau namespace dibuka dalam mode ReadOnly.
WCM_E_INVALIDVALUE, WCM_E_INVALIDVALUEFORMAT, atau WCM_E_INVALIDDATATYPE
 Menunjukkan bahwa nilai yang disediakan untuk kunci tidak dapat dikoercasikan ke jenis yang sesuai, seperti nilai string yang dikoercasikan ke bilangan bulat yang tidak ditandatangani.
WCM_E_WRONGESCAPESTRING
 Menunjukkan bahwa jalur berisi urutan escape XML yang tidak dikenal.
WCM_E_INVALIDKEY
 Menunjukkan bahwa jalur salah ditentukan dan mereferensikan kunci yang salah untuk item daftar.

Keterangan

Catatan Saat membuat item daftar skalar, Anda harus menetapkan nilai pada ISettingsItem yang dihasilkan sebelum merilisnya, atau tidak akan bertahan.
 

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header wcmconfig.h
DLL SMIEngine.dll

Lihat juga

ISettingsItem