Fungsi MprConfigInterfaceCreate (mprapi.h)

Artikel
08/24/2023

Fungsi MprConfigInterfaceCreate membuat antarmuka router dalam konfigurasi router yang ditentukan.

Sintaks

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Parameter

[in] hMprConfig

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 mencakup 0, 1, 2, dan 3, seperti yang tercantum dalam tabel berikut.

Nilai	Format Struktur
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 atau yang lebih baru: MPR_INTERFACE_3

[in] lpbBuffer

Penunjuk ke MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2, atau struktur MPR_INTERFACE_3 . Parameter dwLevel menunjukkan jenis struktur.

[out] phRouterInterface

Penunjuk ke variabel handel. Variabel ini menerima handel ke konfigurasi antarmuka.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

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

Nilai	Makna
ERROR_INVALID_PARAMETER	Setidaknya salah satu hal berikut ini benar: hMprConfig adalah NULL dwLevel bukan 0, 1, 2, atau 3. lpbBuffer adalah NULL phRouterInterface adalah NULL
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Keterangan

Fungsi MprAdminInterfaceCreate mendukung struktur MPR_INTERFACE_2 . Namun, MprConfigInterfaceCreate tidak. Untuk membuat antarmuka putar nomor permintaan yang persisten setelah reboot, panggil MprAdminInterfaceCreate dengan MPR_INTERFACE_2, lalu panggil MprConfigInterfaceCreate dengan MPR_INTERFACE_0 atau MPR_INTERFACE_1.

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