Fungsi MprAdminInterfaceCreate (mprapi.h)

Artikel
08/24/2023

Fungsi MprAdminInterfaceCreate membuat antarmuka pada server tertentu.

Sintaks

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

Parameter

[in] hMprServer

Tangani ke perute untuk menjalankan panggilan ini. Dapatkan handel ini dengan memanggil MprAdminServerConnect.

[in] dwLevel

Nilai DWORD yang menjelaskan format di mana informasi disusun dalam parameter lpBuffer . 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] phInterface

Penunjuk ke variabel HANDLE . Variabel menerima handel untuk digunakan dalam semua panggilan berikutnya untuk mengelola antarmuka ini.

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_ACCESS_DENIED	Aplikasi panggilan tidak memiliki hak istimewa yang memadai.
ERROR_DDM_NOT_RUNNING	Jenis antarmuka router tidak didukung karena Dynamic Interface Manager dikonfigurasi untuk berjalan hanya pada LAN.
ERROR_INTERFACE_ALREADY_EXISTS	Antarmuka dengan nama yang sama sudah ada.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NOT_SUPPORTED	Nilai dwLevel tidak valid.

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