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 からの値です。

リターン コード 説明
ERROR_NOT_NAP_CAPABLE
 hRasConn パラメーターに対応する接続が NAP 用に構成されていません。
ERROR_INVALID_SIZE
 RASNAPSTATE 構造体の dwSize パラメーターに無効なサイズ値があります。
ERROR_INVALID_HANDLE
 関数に渡されるハンドルが NULL または無効です。
ERROR_NO_CONNECTION
 RASMAN は、ハンドルの一覧でハンドルを見つけることができませんでした。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ras.h
Library Rasapi32.lib
[DLL] Rasapi32.dll