MprAdminConnectionGetInfoEx 函式 (mprapi.h)

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

輸出上的指標，指向 RAS_CONNECTION_EX 結構，其中包含 hRasServer 中 RRAS 伺服器的連線資訊。

若要釋放此記憶體，請呼叫 MprAdminBufferFree。

傳回值

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

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
ERROR_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_DDM_NOT_RUNNING	[需求撥號管理器] (DDM) 未執行。
ERROR_PROC_NOT_FOUND	找不到指定的程式。
其他	來自 MprError.h、RasError.h 或 WinError.h 的錯誤。

備註

呼叫端應該藉由呼叫 MprAdminBufferFree 函式來釋放 pRasConnection 所指向的記憶體。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台	Windows
標頭	mprapi.h
程式庫	Mprapi.lib
Dll	Mprapi.dll

另請參閱

MprAdminBufferFree

MprAdminConnectionEnum

MprAdminConnectionGetInfo

RAS 系統管理功能

遠端訪問服務管理參考