struktur RAS_PORT_0

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

Struktur RAS_PORT_0 berisi informasi yang menjelaskan port RAS.

Sintaks

typedef struct _RAS_PORT_0 {
  WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
  WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
  WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
  WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
  DWORD reserved;
  DWORD Flags;
  WCHAR wszUserName[UNLEN + 1];
  WCHAR wszComputer[NETBIOS_NAME_LEN];
  DWORD dwStartSessionTime;
  WCHAR wszLogonDomain[DNLEN + 1];
  BOOL  fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;

Anggota

wszPortName

String Unicode yang dihentikan null yang menentukan nama port, seperti "COM1".

wszDeviceType

String Unicode yang dihentikan null yang menentukan jenis perangkat tempat koneksi dibuat, seperti Modem atau ISDN. Daftar jenis perangkat yang mungkin ditentukan dalam anggota ini mencakup semua jenis perangkat yang diinstal di server, termasuk perangkat pihak ketiga.

wszDeviceName

String Unicode null-terminated yang menentukan nama perangkat tempat koneksi dibuat, seperti "Hayes 9600" atau "PCIMACISDN1".

wszMediaName

Menentukan string Unicode yang dihentikan null yang menentukan nama media yang digunakan untuk koneksi, seperti rasser atau rastapi.

Dipesan

Dicadangkan.

Bendera

Menentukan sekumpulan bendera bit yang menentukan sifat koneksi yang dibuat pada port ini. Anggota ini bisa menjadi kombinasi dari bendera berikut.

Nilai	Makna
GATEWAY_ACTIVE	Jika bendera ini diatur, gateway NetBIOS aktif di server.
MESSENGER_PRESENT	Jika bendera ini diatur, layanan messenger berjalan pada klien jarak jauh.
PORT_MULTILINKED	Jika bendera ini diatur, port di-multilink dengan port lain. Gunakan informasi ini untuk menampilkan status koneksi sebagai port multi-tautan. Untuk port multilink, struktur RAS_PORT_STATISTICS berisi dua set statistik: satu untuk port saja, dan satu lagi untuk port gabungan dalam koneksi multilink.
PPP_CLIENT	Jika bendera ini diatur, klien jarak jauh tersambung menggunakan PPP. Jika bendera ini tidak diatur, klien jarak jauh yang tersambung menggunakan protokol AMB.
REMOTE_LISTEN	Jika bendera ini diatur, parameter RemoteListen gateway NetBIOS diatur ke 1 di server.
USER_AUTHENTICATED	Jika bendera ini diatur, klien jarak jauh tersambung ke server dan pengguna telah diautentikasi. Periksa bendera ini untuk memastikan bahwa klien benar-benar terhubung ke port.

Jika bendera MESSENGER_PRESENT, GATEWAY_ACTIVE, dan REMOTE_LISTEN diatur, gunakan layanan messenger untuk mengirim pesan administratif ke klien jarak jauh. Jika MESSENGER_PRESENT dan REMOTE_LISTEN diatur, tetapi GATEWAY_ACTIVE tidak, kirim pesan ke klien hanya dari server RAS tempat klien tersambung.

wszUserName

Untai (karakter) Unicode yang dihentikan null yang menentukan nama pengguna jarak jauh yang tersambung ke port ini.

wszComputer

String Unicode yang dihentikan null yang menentukan nama komputer klien jarak jauh.

dwStartSessionTime

Menentukan waktu, dalam detik dari 1 Januari 1970, bahwa klien terhubung ke server RAS pada port ini. Gunakan fungsi waktu standar untuk memformat nilai ini untuk ditampilkan.

wszLogonDomain

Menentukan string Unicode yang dihentikan null yang menentukan nama domain tempat pengguna jarak jauh diautentikasi. String ini hanya nama domain, tanpa awalan "\\".

fAdvancedServer

Menentukan bendera yang bukan nol jika server RAS yang terkait dengan port ini adalah server tingkat lanjut seperti Windows 2000 Advanced Server. Gunakan informasi ini untuk menentukan nama server yang memiliki database akun pengguna. Jika server RAS adalah server tingkat lanjut, dapatkan nama server akun pengguna dengan menggabungkan awalan "\\" ke nama yang dikembalikan di anggota wszLogonDomain . Ini karena untuk server tingkat lanjut, nama domain masuk lokal sama dengan nama server. Jika server RAS adalah stasiun kerja, gunakan fungsi RasAdminGetUserAccountServer untuk mendapatkan nama server akun pengguna.

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_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum