Metode ISettingsEngine::CreateSettingsContext (wcmconfig.h)

Membuat konteks pengaturan.

Sintaks

HRESULT CreateSettingsContext(
  [in]  DWORD            Flags,
  [in]  void             *Reserved,
  [out] ISettingsContext **SettingsContext
);

Parameter

[in] Flags

Nilai parameter Bendera mungkin 0, menunjukkan "mode normal" atau 0x00000001, menunjukkan LIMITED_VALIDATION_MODE. Dalam mode normal, konteks pengaturan memvalidasi setiap perubahan yang dibuat untuk mencantumkan item terhadap status gambar target saat ini. Misalnya, jika upaya dilakukan untuk membuat elemen daftar yang sudah ada dalam gambar, operasi pembuatan gagal. Dalam LIMITED_VALIDATION_MODE, data kontradiktif tidak diterima. Anda tidak dapat mengubah lalu menambahkan item daftar. Namun, tidak ada upaya yang dilakukan untuk memverifikasi perubahan yang dilakukan terhadap status sistem saat ini. Hanya gunakan LIMITED_VALIDATION_MODE ketika niatnya adalah untuk menulis konteks yang akan diserialisasikan. Jangan tentukan bendera ini saat membuat konteks yang akan digunakan untuk ISettingsEngine::ApplySettingsContext. Jika digunakan, konteks mungkin tidak cukup divalidasi dan mungkin gagal selama aplikasi.

[in] Reserved

Dicadangkan. Harus NULL.

[out] SettingsContext

Penunjuk ke objek ISettingsContext yang mewakili konteks yang dibuat.

Mengembalikan nilai

Metode ini mengembalikan nilai HRESULT. S_OK menunjukkan keberhasilan. Metode ini dapat mengembalikan E_OUTOFMEMORY jika ada sumber daya yang tidak mencukup untuk membuat objek ISettingsContext .

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

ISettingsEngine