Bagikan melalui

Fungsi RpcNsMgmtInqExpAge (rpcnsi.h)

  • Artikel

Fungsi RpcNsMgmtInqExpAge mengembalikan usia kedaluwarsa global untuk salinan lokal data layanan nama.

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

Sintaks

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

Parameter

ExpirationAge

Arahkan ke usia kedaluwarsa default, dalam detik. Nilai ini digunakan oleh semua layanan nama operasi berikutnya.

Nilai kembali

Nilai Makna
RPC_S_OK
 Panggilan berhasil.
 
Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.
 

Keterangan

Fungsi RpcNsMgmtInqExpAge mengembalikan usia kedaluwarsa yang digunakan aplikasi. Usia kedaluwarsa adalah jumlah waktu dalam detik yang dapat ada salinan data lokal dari atribut layanan nama 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.

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.

Aplikasi biasanya hanya boleh menggunakan usia kedaluwarsa default. Namun, untuk kasus khusus, aplikasi dapat menggantikan usia kedaluwarsa global yang disediakan pengguna secara default dengan memanggil RpcNsMgmtSetExpAge. Fungsi RpcNsMgmtInqExpAge mengembalikan usia kedaluwarsa global saat ini, baik nilai default maupun yang disediakan pengguna. Aplikasi juga dapat mengganti usia kedaluwarsa global untuk sementara waktu dengan memanggil fungsi RpcNsMgmtHandleSetExpAge .

Persyaratan

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

RpcNsMgmtSetExpAge