Fungsi MprAdminPortGetInfo (mprapi.h)

  • Artikel

Fungsi MprAdminPortGetInfo mendapatkan informasi untuk port tertentu.

Sintaks

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

Parameter

[in] hRasServer

Tangani ke komputer server RAS untuk mengumpulkan informasi port. Dapatkan handel ini dengan memanggil MprAdminServerConnect.

[in] dwLevel

Nilai DWORD yang menjelaskan format di mana informasi dikembalikan dalam parameter lplpbBuffer . Nilai yang dapat diterima untuk dwLevel menyertakan 0 dan 1 seperti yang tercantum dalam tabel berikut.

Nilai Format Struktur
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

Tangani ke port untuk mengumpulkan informasi. Dapatkan handel ini dengan memanggil MprAdminPortEnum.

[out] lplpbBuffer

Setelah berhasil diselesaikan, penunjuk ke struktur yang menjelaskan port. Struktur ini berjenis RAS_PORT_0 atau RAS_PORT_1 tergantung pada nilai parameter dwLevel . Bebaskan memori ini dengan memanggil MprAdminBufferFree.

Mengembalikan nilai

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_DDM_NOT_RUNNING
 Demand Dial Manager (DDM) tidak berjalan, mungkin karena Dynamic Interface Manager (DIM) dikonfigurasi untuk berjalan hanya pada LAN.
ERROR_INVALID_PARAMETER
 Setidaknya salah satu parameter berikut adalah NULL atau tidak menunjuk ke memori yang valid: lplpBuffer, lpdwEntriesRead, atau lpdwTotalEntries.
ERROR_INVALID_PORT_HANDLE
 Parameter hPort tidak valid.
ERROR_NOT_SUPPORTED
 Parameter dwLevel bukan nol.
Lainnya
 Kesalahan dari MprError.h, RasError.h, atau WinError.h.
 
 

Keterangan

Fungsi ini tersedia pada Windows NT 4.0 jika RRAS redistributable diinstal. Namun, versi Mprapi.dll yang dikirim dengan RRAS redistributable mengekspor fungsi sebagai RasAdminPortGetInfo daripada MprAdminPortGetInfo. Oleh karena itu, saat menggunakan RRAS redistributable, gunakan LoadLibrary dan GetProcAddress untuk mengakses fungsi ini.

Persyaratan

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

Lihat juga

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

Fungsi Administrasi RAS

Referensi Administrasi Layanan Akses Jarak Jauh