RasGetProjectionInfoEx 関数 (ras.h)

  • [アーティクル]

RasGetProjectionInfoEx 関数は、ローカル クライアント上のすべての RAS 接続に対するポイントツーポイント プロトコル (PPP) またはインターネット キー Exchange バージョン 2 (IKEv2) リモート アクセス プロジェクション操作に関する情報を取得します。

構文

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

パラメーター

[in] hrasconn

トンネル エンドポイントを変更する RAS 接続へのハンドル。 これは、 RasDial 関数または RasEnumConnections 関数によって返されるハンドルです。

[in, out] pRasProjection

RAS 接続のプロジェクション情報を受け取る RAS_PROJECTION_INFO 構造体へのポインター。

[in, out] lpdwSize

pRasProjection が指すバッファーのサイズをバイト単位で指定するポインター (入力)。 出力時に、この変数は、pRasProjection が指すRAS_PROJECTION_INFO構造体の数を格納するために必要なバッファーのサイズ (バイト単位) を受け取ります。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかのエラー コードか、 ルーティングおよびリモート アクセス エラー コード または Winerror.h からの値です。

値 意味
ERROR_BUFFER_TOO_SMALL
 pRasProjection が指すバッファーは、要求された情報を格納するのに十分な大きさではありません。
ERROR_INVALID_HANDLE
 hrasconn パラメーターは有効なハンドルではありません。
ERROR_INVALID_PARAMETER
 関数が無効なパラメーターで呼び出されました。
ERROR_INVALID_SIZE
 pRasProjection が指す構造体の dwSize メンバーは、無効なサイズを指定します。
ERROR_PROTOCOL_NOT_CONFIGURED
 情報が要求された制御プロトコルは、接続の電話帳エントリでプロトコルのネゴシエートを試みる必要がないため、成功も失敗もしませんでした。

注釈

リモート アクセス プロジェクションは、リモート アクセス サーバーとリモート クライアントがネットワーク プロトコル固有の情報をネゴシエートするプロセスです。 リモート アクセス サーバーは、このネットワーク プロトコル固有の情報を使用して、ネットワーク上のリモート クライアントを表します。

リモート アクセスプロジェクション情報は、オペレーティング システムがリモート アクセス接続で RASCS_Projected 状態を実行するまで使用できません。 RasGetProjectionInfoEx がRASCS_Projected状態より前に呼び出されると、ERROR_PROJECTION_NOT_COMPLETEが返されます。

要件

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

こちらもご覧ください

リモート アクセス サービス (RAS) の概要

リモート アクセス サービス関数