RasGetNapStatus 函式 (ras.h)

RasGetNapStatus 函式會擷取指定遠端訪問連線的網路存取保護 (NAP) 連線狀態變數。

語法

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

[in] hRasconn

連接的句柄。使用 RasDial 或 RasEnumConnections 來取得此句柄。

[in, out] pRasNapState

RASNAPSTATE 結構的指標。在輸入時，結構的 dwSize 成員必須設定為 sizeof (RASNAPSTATE) 。在輸出上， pNapState 會傳回 RAS 連線的 NAP 狀態。

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，傳回值是下列其中一個錯誤碼，或是路由和遠端訪問錯誤碼或 Winerror.h 中的值。

傳回碼	Description
ERROR_NOT_NAP_CAPABLE	對應至 hRasConn 參數的連接未針對 NAP 進行設定。
ERROR_INVALID_SIZE	RASNAPSTATE 結構的 dwSize 參數具有無效的大小值。
ERROR_INVALID_HANDLE	傳遞至函式的句柄為 NULL 或無效。
ERROR_NO_CONNECTION	RASMAN 在其句柄清單中找不到句柄。