Fungsi MprAdminServerConnect (mprapi.h)
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 |
---|---|
|
Aplikasi panggilan tidak memiliki hak istimewa yang memadai. |
|
Fungsi ini dipanggil dengan parameter phMprServer sama dengan NULL. |
|
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 |