Fungsi RasAdminPortGetInfo

[Fungsi ini disediakan hanya untuk kompatibilitas mundur dengan Windows NT Server 4.0. Ini mengembalikan ERROR_CALL_NOT_IMPLEMENTED pada Windows Server 2003. Aplikasi harus menggunakan fungsi MprAdminPortGetInfo .]

Fungsi RasAdminPortGetInfo mengambil informasi tentang port tertentu pada server tertentu.

Sintaks

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

Parameter

lpszServer [in]

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama server RAS. Tentukan nama dengan karakter "\\" di depannya, dalam formulir: \\servername.

lpszPort [in]

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama port pada server.

pRasPort1 [out]

Arahkan ke struktur RAS_PORT_1 yang diisi fungsi dengan informasi tentang status port.

pRasStats [out]

Arahkan ke struktur RAS_PORT_STATISTICS yang diisi fungsi dengan statistik tentang port.

ppRasParams [out]

Penunjuk ke variabel penunjuk yang menerima alamat array struktur RAS_PARAMETERS . Setiap struktur berisi nama kunci khusus media, seperti MAXCONNECTBPS, dan nilai terkaitnya. Ketika aplikasi selesai dengan memori ini, bebaskan dengan memanggil fungsi RasAdminFreeBuffer .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

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

Nilai	Makna
ERROR_DEV_NOT_EXIST	Port yang ditentukan tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak mencukupi untuk mengalokasikan buffer untuk array ppRasParams .

Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.

Persyaratan

Persyaratan	Nilai
Akhir dukungan klien	Windows 2000 Professional
Akhir dukungan server	Windows 2000 Server
Header	Rassapi.h
Pustaka	Rassapi.lib
DLL	Rassapi.dll

Lihat juga

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Administrasi Server RAS

RAS_PARAMETERS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminFreeBuffer