Metode ISettingsItem::CreateListElement (wcmconfig.h)

  • Artikel

Membuat elemen daftar baru.

Sintaks

HRESULT CreateListElement(
  [in]  const VARIANT *KeyData,
  [out] ISettingsItem **Child
);

Parameter

[in] KeyData

Informasi untuk kunci yang menentukan identitas item daftar baru. Untuk menentukan nilai yang benar untuk parameter data utama, lihat informasi yang dikembalikan dari ISettingsItem::GetListKeyInformation. Varian yang diperoleh dari ISettingsItem::GetListKeyInformation harus dapat dikoerksi dengan jenis kunci. Jika metode ISettingsItem::GetListKeyInformation mengembalikan S_FALSE, gunakan jenis string untuk data kunci.

[out] Child

Penunjuk ke item daftar ISettingsItem yang baru dibuat.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Menunjukkan keberhasilan.
HRESULT_FROM_WIN32 (ERROR_INVALID_OPERATION)
 Menunjukkan bahwa metode dipanggil pada item yang bukan dari daftar jenis pengaturan.
WCM_E_INVALIDVALUE, WCM_E_INVALIDVALUEFORMAT, atau WCM_E_INVALIDDATATYPE
 Menunjukkan upaya untuk membuat daftar di mana kunci tidak dapat dipaksa ke jenis yang benar.
WCM_E_READONLYITEM
Menunjukkan bahwa item tidak dapat ditulis, baik karena merupakan item baca-saja, atau karena namespace dibuka dalam mode ReadOnly.

Keterangan

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

Persyaratan

Persyaratan Nilai
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