Fungsi RpcServerRegisterIf (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcServerRegisterIf mendaftarkan antarmuka dengan pustaka run-time RPC.

Sintaks

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

Parameter

IfSpec

Struktur yang dihasilkan MIDL menunjukkan antarmuka untuk mendaftar.

MgrTypeUuid

Arahkan ke UUID jenis untuk dikaitkan dengan parameter MgrEpv . Menentukan nilai parameter null (atau UUID nihil) mendaftarkan IfSpec dengan UUID jenis nil.

MgrEpv

Vektor titik masuk (EPV) rutin manajer. Untuk menggunakan EPV default yang dihasilkan MIDL, tentukan nilai null. Untuk informasi lebih lanjut, silakan lihat RPC_MGR_EPV.

Nilai kembali

Mengembalikan RPC_S_OK setelah berhasil.

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

Keterangan

Server dapat mendaftarkan jumlah antarmuka yang tidak terbatas dengan pustaka run-time RPC. Pendaftaran membuat antarmuka tersedia untuk klien menggunakan handel pengikatan ke server. Untuk mendaftarkan antarmuka, kode aplikasi server memanggil RpcServerRegisterIf. Untuk setiap implementasi antarmuka yang ditawarkan server, ia harus mendaftarkan EPV manajer terpisah.

Saat memanggil RpcServerRegisterIf, server menyediakan informasi berikut:

Spesifikasi antarmuka
Spesifikasi antarmuka adalah struktur data yang dihasilkan kompilator MIDL. Server menentukan antarmuka menggunakan parameter IfSpec .
UUID jenis manajer dan manajer EPV
UUID jenis manajer dan manajer EPV menentukan rutinitas manajer mana yang dijalankan ketika server menerima permintaan panggilan prosedur jarak jauh dari klien.

Server menentukan UUID dan EPV jenis manajer menggunakan parameter MgrTypeUuid dan MgrEpv . Perhatikan bahwa saat menentukan UUID non-nihil manager-type, server juga harus memanggil fungsi RpcObjectSetType untuk mendaftarkan objek dari jenis non-nihil ini.

Jika aplikasi server Anda perlu mendaftarkan antarmuka mendengarkan otomatis atau menggunakan fungsi panggilan balik untuk tujuan autentikasi, gunakan RpcServerRegisterIfEx.

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