Fungsi RasGetProjectionInfoEx (ras.h)

  • Artikel

Fungsi RasGetProjectionInfoEx mendapatkan informasi tentang operasi proyeksi akses jarak jauh Point-to-Point Protocol (PPP) atau Internet Key Exchange versi 2 (IKEv2) untuk semua koneksi RAS pada klien lokal.

Sintaks

DWORD RasGetProjectionInfoEx(
  [in]      HRASCONN             hrasconn,
  [in, out] PRAS_PROJECTION_INFO pRasProjection,
  [in, out] LPDWORD              lpdwSize
);

Parameter

[in] hrasconn

Handel ke koneksi RAS tempat titik akhir terowongan akan diubah. Ini bisa menjadi handel yang dikembalikan oleh fungsi RasDial atau RasEnumConnections .

[in, out] pRasProjection

Penunjuk ke struktur RAS_PROJECTION_INFO yang menerima informasi proyeksi untuk koneksi RAS.

[in, out] lpdwSize

Penunjuk, dalam input, yang menentukan ukuran, dalam byte, dari buffer yang diacu oleh pRasProjection. Pada output, variabel ini menerima ukuran, dalam byte, dari buffer yang diperlukan untuk menyimpan jumlah struktur RAS_PROJECTION_INFO yang diacu oleh pRasProjection.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut atau nilai dari Kode Kesalahan Perutean dan Akses Jarak Jauh atau Winerror.h.

Nilai Makna
ERROR_BUFFER_TOO_SMALL
 Buffer yang ditujukkan oleh pRasProjection tidak cukup besar untuk berisi informasi yang diminta.
ERROR_INVALID_HANDLE
 Parameter hrasconn bukan handel yang valid.
ERROR_INVALID_PARAMETER
 Fungsi ini dipanggil dengan parameter yang tidak valid.
ERROR_INVALID_SIZE
 Anggota dwSize dari struktur yang diarahkan oleh pRasProjection menentukan ukuran yang tidak valid.
ERROR_PROTOCOL_NOT_CONFIGURED
 Protokol kontrol yang informasinya diminta tidak berhasil atau gagal, karena entri buku telepon koneksi tidak mengharuskan upaya untuk menegosiasikan protokol dibuat.

Keterangan

Proyeksi akses jarak jauh adalah proses di mana server akses jarak jauh dan klien jarak jauh menegosiasikan informasi khusus protokol jaringan. Server akses jarak jauh menggunakan informasi khusus protokol jaringan ini untuk mewakili klien jarak jauh pada jaringan.

Informasi proyeksi akses jarak jauh tidak tersedia sampai sistem operasi menjalankan status RASCS_Projected pada koneksi akses jarak jauh. Jika RasGetProjectionInfoEx dipanggil sebelum status RASCS_Projected, rasGetProjectionInfoEx akan mengembalikan ERROR_PROJECTION_NOT_COMPLETE.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header ras.h
Pustaka Rasapi32.lib
DLL Rasapi32.dll

Lihat juga

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh