Fungsi MprConfigServerSetInfo (mprapi.h)

Artikel
03/15/2023

Fungsi MprConfigServerSetInfo digunakan untuk mengatur jumlah port untuk port L2TP, PPTP, dan SSTP dan mengaktifkan atau menonaktifkan RRAS di registri ketika layanan RRAS tidak berjalan sehingga diambil saat sistem dimulai ulang di lain waktu.

Sintaks

DWORD MprConfigServerSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parameter

[in] hMprServer

Tangani ke konfigurasi router. Dapatkan handel ini dengan memanggil MprConfigServerConnect.

[in] dwLevel

Nilai DWORD yang menjelaskan format di mana informasi disusun dalam parameter lpbBuffer . Nilai yang dapat diterima untuk dwLevel menyertakan 1 dan 2 seperti yang tercantum dalam tabel berikut.

Nilai	Format Struktur
1	Windows Server 2003 atau yang lebih baru: MPR_SERVER_1
2	Windows Server 2008 atau yang lebih baru: MPR_SERVER_2

[in] lpbBuffer

Penunjuk ke MPR_SERVER_1
atau struktur MPR_SERVER_2 . Parameter dwLevel menunjukkan jenis struktur.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah 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.
ERROR_SUCCESS_REBOOT_REQUIRED	Reboot sistem diperlukan agar perubahan tersebut dapat diterapkan. Ubah jumlah port menggunakan panggilan MprConfigServerSetInfo dan reboot.
ERROR_INVALID_PARAMETER	Jika Anda mencoba mengatur jumlah port ke lebih dari batas yang didukung sistem seperti yang ditentukan pada topik MPR_SERVER_1 dan MPR_SERVER_2 . Mengembalikan kesalahan ini jika Anda mencoba mengatur jumlah port PPTP ke 0. Mengembalikan kesalahan ini jika bendera tidak valid atau jika lpbBuffer atau hMprServer adalah NULL.
ERROR_NOT_SUPPORTED	Nilai dwLevel tidak valid.
ERROR_INVALID_HANDLE	Handel hMprServer tidak valid.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Keterangan

Perubahan pada konfigurasi server ini persisten, tetapi tidak berpengaruh pada server RRAS hingga dimulai ulang.

Contoh

Topik Pengaturan port L2TP dan PPTP dari layanan RRAS lokal menunjukkan fungsi ini sedang digunakan.

Persyaratan


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