Fungsi MprAdminServerConnect (mprapi.h)

  • Artikel

Fungsi MprAdminServerConnect membuat koneksi ke router untuk tujuan mengelola router tersebut. Panggil fungsi ini sebelum melakukan panggilan lain ke server. Gunakan handel yang dikembalikan dalam panggilan berikutnya untuk mengelola antarmuka di server.

Sintaks

DWORD MprAdminServerConnect(
  [in, optional] LPWSTR            lpwsServerName,
  [out]          MPR_SERVER_HANDLE *phMprServer
);

Parameter

[in, optional] lpwsServerName

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama server jarak jauh. Jika parameter ini NULL, fungsi mengembalikan handel ke komputer lokal.

[out] phMprServer

Penunjuk ke variabel HANDLE yang menerima handel ke server. Gunakan handel ini dalam panggilan berikutnya untuk mengelola server.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai Makna
ERROR_ACCESS_DENIED
 Aplikasi panggilan tidak memiliki hak istimewa yang memadai.
RPC_S_INVALID_BINDING
 Fungsi ini dipanggil dengan parameter phMprServer sama dengan NULL.
RPC_S_UNKNOWN_IF
 Komputer yang ditentukan tidak menjalankan layanan Perutean dan RAS.

Keterangan

MprAdminIsServiceRunning harus digunakan untuk menentukan status layanan RRAS di server jarak jauh. MprAdminServerConnect tidak mengkueri layanan RRAS saat membuat koneksi.

Persyaratan

   
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header mprapi.h
Pustaka Mprapi.lib
DLL Mprapi.dll

Lihat juga

MprAdminServerDisconnect

Fungsi Administrasi Perute

Referensi Manajemen Router