Fungsi RasGetNapStatus (ras.h)

  • Artikel

Fungsi RasGetNapStatus mengambil variabel status koneksi Network Access Protection (NAP) untuk koneksi akses jarak jauh tertentu.

Sintaks

DWORD RasGetNapStatus(
  [in]      HRASCONN      hRasconn,
  [in, out] LPRASNAPSTATE pRasNapState
);

Parameter

[in] hRasconn

Handel ke koneksi. Gunakan RasDial atau RasEnumConnections untuk mendapatkan handel ini.

[in, out] pRasNapState

Penunjuk ke struktur RASNAPSTATE . Pada input, anggota dwSize struktur harus diatur ke sizeof(RASNAPSTATE). Pada output, pNapState mengembalikan status NAP koneksi RAS.

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.

Menampilkan kode Deskripsi
ERROR_NOT_NAP_CAPABLE
 Koneksi yang sesuai dengan parameter hRasConn tidak dikonfigurasi untuk NAP.
ERROR_INVALID_SIZE
 Parameter dwSize dari struktur RASNAPSTATE memiliki nilai ukuran yang tidak valid.
ERROR_INVALID_HANDLE
 Handel yang diteruskan ke fungsi adalah NULL atau tidak valid.
ERROR_NO_CONNECTION
 RASMAN tidak dapat menemukan handel dalam daftar handelnya.

Persyaratan

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