Fungsi RpcMgmtSetAuthorizationFn (rpcdce.h)

Artikel
03/01/2024

Fungsi RpcMgmtSetAuthorizationFn menetapkan fungsi otorisasi untuk memproses panggilan jarak jauh ke fungsi manajemen server.

Sintaks

RPC_STATUS RpcMgmtSetAuthorizationFn(
  RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);

Parameter

AuthorizationFn

Menentukan fungsi otorisasi. Pustaka run-time server RPC secara otomatis memanggil fungsi ini setiap kali run-time server menerima permintaan klien untuk menjalankan salah satu fungsi manajemen jarak jauh. Server harus menerapkan fungsi ini. Aplikasi menentukan nilai NULL untuk membatalkan pendaftaran fungsi otorisasi yang terdaftar sebelumnya. Setelah panggilan seperti itu, otorisasi default digunakan.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.

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

Keterangan

Aplikasi server memanggil fungsi RpcMgmtSetAuthorizationFn untuk membangun fungsi otorisasi yang mengontrol akses ke fungsi manajemen jarak jauh server. Ketika server belum memanggil RpcMgmtSetAuthorizationFn, atau memanggil dengan nilai null untuk AuthorizationFn, pustaka run-time server menggunakan otorisasi default berikut.

Fungsi jarak jauh	Otorisasi default
RpcMgmtInqIfIds	Aktif
RpcMgmtInqServerPrincName	Aktif
RpcMgmtInqStats	Aktif
RpcMgmtIsServerListening	Aktif
RpcMgmtStopServerListening	Nonaktif

Dalam tabel sebelumnya, "Diaktifkan" menunjukkan bahwa semua klien dapat menjalankan fungsi jarak jauh, dan "Dinonaktifkan" menunjukkan bahwa semua klien dicegah untuk menjalankan fungsi jarak jauh.

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	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll