RasGetNapStatus 函数 (ras.h)

RasGetNapStatus 函数检索网络访问保护 (NAP) 给定远程访问连接的连接状态变量。

语法

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

[in] hRasconn

连接的句柄。使用 RasDial 或 RasEnumConnections 获取此句柄。

[in, out] pRasNapState

指向 RASNAPSTATE 结构的指针。输入时，结构的 dwSize 成员必须设置为 size of (RASNAPSTATE) 。输出时， pNapState 返回 RAS 连接的 NAP 状态。

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值为以下错误代码之一，或者来自路由和远程访问错误代码或 Winerror.h 的值。

返回代码	说明
ERROR_NOT_NAP_CAPABLE	未为 NAP 配置与 hRasConn 参数对应的连接。
ERROR_INVALID_SIZE	RASNAPSTATE 结构的 dwSize 参数的大小值无效。
ERROR_INVALID_HANDLE	传递给函数的句柄为 NULL 或无效。
ERROR_NO_CONNECTION	RASMAN 在其句柄列表中找不到句柄。