Fungsi RasAdminPortEnum

[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 MprAdminPortEnum .]

Fungsi RasAdminPortEnum menghitung semua port pada server RAS yang ditentukan. Untuk setiap port di server, fungsi mengembalikan struktur RAS_PORT_0 yang berisi informasi tentang port.

Sintaks

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

Parameter

lpszServer [in]

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

ppRasPort0 [out]

Penunjuk ke variabel yang menerima penunjuk ke buffer yang berisi array struktur RAS_PORT_0 . Ketika aplikasi telah selesai dengan memori, bebaskan dengan memanggil fungsi RasAdminFreeBuffer .

pcEntriesRead [out]

Penunjuk ke variabel 16-bit yang menerima jumlah total struktur RAS_PORT_0 yang dikembalikan dalam array ppRasPort0 .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Nilai	Makna
NERR_ItemNotFound	Tidak ada port yang dapat dijumlahkan. Ini bisa jadi karena semua port yang dikonfigurasi pada server saat ini sedang digunakan untuk melakukan panggilan keluar.

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_PORT_0

RasAdminFreeBuffer