MprAdminConnectionGetInfoEx 関数 (mprapi.h)

[アーティクル]
02/29/2024

MprAdminConnectionGetInfoEx 関数は、指定された RRAS サーバー上の特定の接続の接続情報を取得します。

構文

DWORD MprAdminConnectionGetInfoEx(
  [in]  RAS_SERVER_HANDLE  hRasServer,
  [in]  HANDLE             hRasConnection,
  [out] PRAS_CONNECTION_EX pRasConnection
);

パラメーター

[in] hRasServer

接続情報の取得元のコンピューターへのハンドル。このハンドルを取得するには、 MprAdminServerConnect を呼び出します。

[in] hRasConnection

データを取得するための接続へのハンドル。このハンドルを取得するには、 MprAdminConnectionEnum を呼び出します。

[out] pRasConnection

出力時に、hRasServer 内の RRAS サーバーの接続情報を含むRAS_CONNECTION_EX構造体へのポインター。

このメモリを解放するには、 MprAdminBufferFree を呼び出します。

戻り値

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

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

値	意味
ERROR_ACCESS_DENIED	呼び出し元のアプリケーションに十分な特権がありません。
ERROR_DDM_NOT_RUNNING	Demand Dial Manager (DDM) が実行されていません。
ERROR_PROC_NOT_FOUND	指定されたプロシージャが見つかりませんでした。
その他	MprError.h、RasError.h、または WinError.h からのエラー。

注釈

呼び出し元は、関数 MprAdminBufferFree を呼び出すことによって、pRasConnection が指すメモリを解放する必要があります。

要件

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