struktur RAS_PORT_1

[Versi struktur RAS_PORT_1 ini tidak didukung pada Windows Vista. Gunakan RAS_PORT_1 yang lebih baru yang ditentukan dalam mprapi.h sebagai gantinya.]

Struktur RAS_PORT_1 berisi informasi tentang port RAS.

Sintaks

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

Anggota

rasport0

Menentukan struktur RAS_PORT_0 yang berisi informasi tentang port, seperti nama port, nama pengguna jarak jauh yang tersambung ke port, dan sebagainya.

LineCondition

Menentukan status port. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
RAS_PORT_NON_OPERATIONAL	Port tidak beroperasi. Periksa log peristiwa untuk kesalahan yang dilaporkan oleh server.
RAS_PORT_DISCONNECTED	Porta saat ini terputus.
RAS_PORT_CALLING_BACK	Server RAS memanggil kembali klien RAS.
RAS_PORT_LISTENING	Port sedang menunggu klien untuk memanggil masuk.
RAS_PORT_AUTHENTICATING	Server sedang dalam proses mengautentikasi klien jarak jauh.
RAS_PORT_AUTHENTICATED	Klien jarak jauh sekarang diautentikasi.
RAS_PORT_INITIALIZING	Perangkat yang terpasang pada port sedang diinisialisasi. Status port akan berubah menjadi RAS_PORT_LISTENING ketika inisialisasi telah selesai.

HardwareCondition

Menentukan salah satu nilai berikut untuk menunjukkan status perangkat yang dilampirkan ke port.

Nilai	Makna
RAS_MODEM_OPERATIONAL	Modem yang terpasang pada port ini beroperasi dan siap menerima panggilan klien.
RAS_MODEM_HARDWARE_FAILURE	Modem yang terlampir pada porta ini memiliki masalah perangkat keras.

LineSpeed

Menentukan kecepatan, dalam bit per detik, yang dengannya komputer dapat berkomunikasi dengan port.

NumStatistics

Anggota ini tidak digunakan. Fungsi administrasi RAS, seperti fungsi RasAdminPortGetInfo , menggunakan struktur RAS_PORT_STATISTICS untuk mengembalikan statistik port.

NumMediaParms

Menentukan jumlah parameter khusus media untuk port ini. Untuk media serial, biasanya jumlah nilai yang muncul dalam file SERIAL.INI.

SizeMediaParms

Menentukan ukuran, dalam byte, dari buffer yang diperlukan untuk semua parameter khusus media. Fungsi RasAdminPortGetInfo mengembalikan buffer yang berisi array struktur RAS_PARAMETERS dengan parameter media dan nilai untuk port.

ProjResult

Struktur RAS_PPP_PROJECTION_RESULT yang menentukan informasi proyeksi PPP untuk port ini. Struktur ini menyediakan informasi untuk setiap protokol yang dinegosiasikan ketika klien RAS terhubung ke server.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP
Akhir dukungan server	Windows Server 2003
Header	Rassapi.h

Lihat juga

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Struktur Administrasi Server RAS

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo