Bagikan melalui


Fungsi JetSetSystemParameter

Berlaku untuk: Windows | Windows Server

Fungsi JetSetSystemParameter

Fungsi JetSetSystemParameter digunakan untuk mengatur banyak pengaturan konfigurasi mesin database.

    JET_ERR JET_API JetSetSystemParameter(
      __in_out_opt  JET_INSTANCE* pinstance,
      __in          JET_SESID sesid,
      __in          unsigned long paramid,
      __in          JET_API_PTR lParam,
      __in_opt      JET_PCSTR szParam
    );

Parameter

pinstance

Menentukan instans yang akan digunakan untuk panggilan ini.

Windows 2000: Untuk Windows 2000, parameter ini diabaikan dan harus selalu NULL.

Windows XP: Untuk rilis Windows XP dan yang lebih baru, parameter ini agak kelebihan beban. Jika mesin beroperasi dalam mode warisan (mode kompatibilitas Windows 2000) di mana hanya satu instans yang didukung, parameter ini mungkin NULL atau mungkin berisi instans aktual yang dikembalikan oleh JetInit. Dalam kedua kasus, semua pengaturan parameter sistem dibaca dari satu instans tersebut. Jika mesin beroperasi dalam mode multi-instans, parameter ini mungkin NULL atau pointer ke instans yang dibuat menggunakan JetInit atau JetCreateIndex. Ketika parameter ini NULL , maka pengaturan parameter sistem global (atau default) dibaca. Ketika parameter ini adalah instans, maka pengaturan parameter sistem untuk instans tersebut dibaca.

Meskipun ini secara teknis merupakan parameter keluar, API ini tidak pernah memodifikasi konten buffer yang disediakan.

sesid

Menentukan sesi yang akan digunakan untuk panggilan ini.

Ketika ditentukan, instans yang ditentukan diabaikan dan instans yang terkait dengan sesi akan digunakan.

paramid

ID parameter sistem yang akan diatur. Lihat Parameter Sistem untuk daftar lengkap parameter sistem dan propertinya.

lParam

Menyediakan nilai yang akan diatur untuk parameter sistem yang dipilih jika parameter sistem tersebut berjenis bilangan bulat.

szParam

Menyediakan nilai untuk parameter sistem yang dipilih jika parameter sistem tersebut adalah jenis string.

Tampilkan Nilai

Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan ESE, lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.

Menampilkan kode

Deskripsi

JET_errSuccess

Operasi berhasil diselesaikan.

Windows Vista: Pada Windows Vista dan rilis yang lebih baru, keberhasilan dapat dikembalikan tanpa perubahan pada nilai parameter sistem. Lihat parameter sistem JET_paramEnableAdvanced dalam topik Parameter Meta untuk informasi selengkapnya.

JET_errAlreadyInitialized

Instans telah diinisialisasi menggunakan panggilan ke JetInit dan operasi ini tidak dapat dilakukan sebagai hasilnya. Ini dapat terjadi untuk JetSetSystemParameter ketika upaya dilakukan untuk mengonfigurasi parameter sistem setelah perubahan nilainya tidak dapat memengaruhi status mesin database.

JET_errClientRequestToStopJetService

Tidak mungkin untuk menyelesaikan operasi karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti sebagai akibat dari panggilan ke JetStopService.

JET_errIndexTuplesInvalidLimits

Parameter indeks tuple yang ditentukan ilegal. Kesalahan ini dapat dikembalikan oleh JetSetSystemParameter hanya saat mengatur JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax, atau JET_paramIndexTuplesToIndexMax ke nilai ilegal.

Windows XP dan Windows Server 2003: Ini hanya dapat terjadi pada Windows XP dan Windows Server 2003.

JET_errInitInProgress

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi sedang diinisialisasi.

JET_errInstanceUnavailable

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi telah mengalami kesalahan fatal yang mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut.

Windows XP: Kesalahan ini hanya akan dikembalikan oleh Windows XP dan rilis yang lebih baru.

JET_errInvalidParameter

Salah satu parameter yang disediakan berisi nilai yang tidak terduga atau berisi nilai yang tidak masuk akal ketika dikombinasikan dengan nilai parameter lain. Ini dapat terjadi untuk JetSetSystemParameter ketika:

  • ID parameter sistem yang ditentukan tidak valid atau tidak didukung.

  • Upaya dilakukan untuk mengatur parameter sistem bernilai string dengan string yang panjangnya berada di luar rentang hukum untuk parameter .

  • Upaya dilakukan untuk menetapkan parameter sistem bernilai string dengan jalur file di mana panjang representasi jalur absolutnya berada di luar rentang hukum untuk parameter tersebut.

    Windows Vista: Ini hanya dapat terjadi pada Windows Vista dan rilis yang lebih baru.

  • Upaya dilakukan untuk menetapkan parameter sistem bernilai bilangan bulat dengan bilangan bulat yang berada di luar rentang hukum untuk parameter .

  • Upaya dilakukan untuk mengatur JET_paramUnicodeIndexDefault dengan pointer JET_UNICODEINDEXNULL, LCID yang tidak valid, atau set bendera LCMapString yang tidak didukung.

    Windows Vista: Ini hanya dapat terjadi pada Windows Vista dan rilis yang lebih baru.

  • Parameter sistem yang ditentukan tidak dapat diatur karena bersifat baca-saja.

  • Upaya dilakukan untuk mengatur parameter sistem setelah JetInit dipanggil, mesin database dalam mode instans tunggal, dan sesi tidak ditentukan.

    Windows XP dan Windows Server 2003: Ini hanya dapat terjadi pada Windows XP dan Windows Server 2003.

  • Parameter sistem yang ditentukan hanya global dan upaya dilakukan untuk mengatur nilai spesifik instans untuk parameter sistem tersebut.

    Windows XP dan Windows Server 2003: Ini hanya dapat terjadi pada Windows XP dan Windows Server 2003.

  • Parameter sistem yang ditentukan hanya per instans dan upaya dilakukan untuk mengatur nilai global untuk parameter sistem tersebut.

    Windows XP dan Windows Server 2003: Ini hanya dapat terjadi pada Windows XP dan Windows Server 2003.

JET_errInvalidPath

Jalur sistem file yang ditentukan tidak valid. Kesalahan ini dapat dikembalikan oleh JetSetSystemParameter hanya saat mengatur parameter sistem yang mewakili jalur sistem file. Misalnya, JET_paramSystemPath dapat mengembalikan kesalahan ini.

JET_errNotInitialized

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi belum diinisialisasi.

JET_errRestoreInProgress

Tidak dimungkinkan untuk menyelesaikan operasi karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.

JET_errTermInProgress

Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi sedang dimatikan.

JET_errInvalidSesid

Handel sesi tidak valid atau mengacu pada sesi tertutup.

Kesalahan ini tidak dikembalikan dalam semua keadaan. Handel hanya divalidasi berdasarkan upaya terbaik.

JET_errInvalidInstance

Handel instans tidak valid atau mengacu pada instans yang telah dimatikan.

Kesalahan ini tidak dikembalikan dalam semua keadaan. Handel hanya divalidasi berdasarkan upaya terbaik.

Windows Vista: Kesalahan ini hanya akan dikembalikan oleh Windows Vista dan rilis yang lebih baru.

Jika berhasil, pengaturan untuk parameter sistem akan diatur ke nilai yang disediakan.

Jika gagal, pengaturan untuk parameter sistem akan tetap tidak berubah.

Keterangan

JetSetSystemParameter melakukan pekerjaan yang buruk untuk memvalidasi pengaturan yang dipilih untuk setiap parameter sistem. Perawatan harus diambil agar tidak mengandalkan validasi ini untuk menerapkan pengaturan yang baik. Harap perhatikan dengan cermat deskripsi setiap parameter sistem dan ikuti panduan tersebut untuk pengaturan parameter sistem yang baik.

Ada serangkaian parameter sistem yang harus selalu diatur untuk menjamin bahwa mesin database berfungsi seperti yang dimaksudkan. Secara khusus, parameter sistem apa pun yang memengaruhi tata letak fisik file yang digunakan oleh mesin database harus selalu diatur. Untuk informasi selengkapnya, lihat Parameter Sistem.

Setiap parameter sistem memiliki nilai default. Nilai default ini telah berevolusi dari waktu ke waktu dan cukup arbitrer. Sangat disarankan agar aplikasi mengevaluasi semua nilai default untuk memastikan bahwa nilai tersebut sesuai. Jika tidak sesuai, maka mereka harus dikonfigurasi oleh aplikasi. Ini penting karena banyak parameter ini dapat sangat berdampak pada keandalan, performa, dan pemanfaatan sumber daya mesin database.

Persyaratan

Persyaratan Nilai

Klien

Memerlukan Windows Vista, Windows XP, atau Windows 2000 Professional.

Server

Memerlukan Windows Server 2008, Windows Server 2003, atau Windows 2000 Server.

Header

Dinyatakan dalam Esent.h.

Pustaka

Gunakan ESENT.lib.

DLL

Membutuhkan ESENT.dll.

Unicode

Diimplementasikan sebagai JetSetSystemParameterW (Unicode) dan JetSetSystemParameterA (ANSI).

Lihat juga

JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
Parameter Sistem