Fungsi RpcNsMgmtSetExpAge (rpcnsi.h)

Fungsi RpcNsMgmtSetExpAge memodifikasi usia kedaluwarsa global aplikasi untuk salinan lokal data layanan nama.

Catatan Fungsi ini tidak didukung pada Windows Vista dan sistem operasi yang lebih baru.

 

Sintaks

RPC_STATUS RpcNsMgmtSetExpAge(
  unsigned long ExpirationAge
);

Parameter

ExpirationAge

Arahkan ke usia kedaluwarsa default, dalam detik. Nilai ini digunakan oleh semua layanan nama–operasi berikutnya. Usia kedaluwarsa 0 menyebabkan pembaruan segera data layanan nama lokal.

Untuk mengatur ulang usia kedaluwarsa ke nilai default yang ditetapkan RPC selama dua jam, tentukan nilai RPC_C_NS_DEFAULT_EXP_AGE.

Menampilkan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_NAME_SERVICE_UNAVAILABLE	Layanan nama tidak tersedia.

 

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

 

Keterangan

Fungsi RpcNsMgmtSetExpAge memodifikasi usia kedaluwarsa global aplikasi. Usia kedaluwarsa adalah jumlah waktu salinan data lokal dari atribut layanan nama dapat ada sebelum permintaan dari aplikasi untuk atribut memerlukan pembaruan salinan lokal. Ketika aplikasi mulai berjalan, pustaka run-time RPC menentukan usia kedaluwarsa default dua jam. Defaultnya adalah global untuk aplikasi. Biasanya, Anda harus menghindari penggunaan RpcNsMgmtSetExpAge. Sebagai gantinya, Anda harus mengandalkan usia kedaluwarsa default.

Usia kedaluwarsa digunakan oleh operasi Pointer berikutnya (yang membaca data dari atribut layanan nama). Operasi berikutnya biasanya dimulai dengan mencari salinan lokal data atribut yang diminta oleh aplikasi. Dengan tidak adanya salinan lokal, operasi berikutnya membuatnya dengan data atribut baru dari database layanan nama. Jika salinan lokal sudah ada, operasi membandingkan usia aktualnya dengan usia kedaluwarsa yang digunakan oleh aplikasi. Jika usia aktual melebihi usia kedaluwarsa, operasi secara otomatis mencoba memperbarui salinan lokal dengan data atribut baru. Jika pembaruan tidak mungkin, data lokal lama tetap ada dan operasi berikutnya gagal, mengembalikan kode status RPC_S_NAME_SERVICE_UNAVAILABLE.

Mengatur usia kedaluwarsa ke nilai kecil menyebabkan operasi Pointer berikutnya sering memperbarui data lokal untuk atribut layanan nama apa pun yang diminta oleh aplikasi Anda. Misalnya, mengatur usia kedaluwarsa ke 0 memaksa semua operasi berikutnya untuk memperbarui data lokal untuk atribut layanan nama yang diminta oleh aplikasi Anda. Oleh karena itu, menetapkan usia kedaluwarsa yang kecil dapat menciptakan masalah performa untuk aplikasi Anda dan meningkatkan lalu lintas jaringan. Selain itu, jika aplikasi Anda menggunakan server layanan nama jarak jauh, usia kedaluwarsa kecil dapat berdampak buruk pada performa jaringan untuk semua aplikasi.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcnsi.h (termasuk Rpc.h)
Pustaka	Rpcns4.lib
DLL	Rpcns4.dll

Lihat juga

RpcNsMgmtHandleSetExpAge