mprAdminConnectionGetInfo 函式 (mprapi.h)

發行項
02/29/2024

MprAdminConnectionGetInfo 函式會擷取特定連線的相關數據。

語法

DWORD MprAdminConnectionGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hRasConnection,
  [out] LPBYTE            *lplpbBuffer
);

參數

[in] hRasServer

擷取連接信息的計算機句柄。若要取得此句柄，請呼叫 MprAdminServerConnect。

[in] dwLevel

DWORD 值，描述 lplpbBuffer 參數中傳回資訊的格式。 dwLevel 可接受的值包括 0、1、2 和 3，如下表所列。

Windows NT 4.0：此參數必須為零。

值	結構格式
0	RAS_CONNECTION_0
1	Windows 2000 或更新版本： RAS_CONNECTION_1
2	Windows 2000 或更新版本： RAS_CONNECTION_2
3	Windows Server 2008 或更新版本： RAS_CONNECTION_3

[in] hRasConnection

要擷取相關數據的連接句柄。若要取得此句柄，請呼叫 MprAdminConnectionEnum。

[out] lplpbBuffer

成功完成時，描述連接之結構的陣列指標。這些結構的類型RAS_CONNECTION_0、 RAS_CONNECTION_1、 RAS_CONNECTION_2或 RAS_CONNECTION_3，視 dwLevel 參數的值而定。

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

傳回值

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

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

傳回碼	Description
ERROR_INVALID_PARAMETER	RAS 伺服器的句柄或 RAS 連線的句柄無效。
ERROR_INVALID_LEVEL	針對 dwLevel 傳遞的值不是零、一、二或三。只有 Windows 2000 或更新版本才支援層級 1 和 2。只有 Windows Server 2008 或更新版本才支援層級 3。
ERROR_INTERFACE_NOT_CONNECTED	hConnection 句柄無效。
RPC_S_INVALID_BINDING	hRasServer 句柄無效。
其他	MprError.h、RasError.h 或 WinError.h 的錯誤。

備註

如果已安裝 RRAS 可轉散發套件，此函式可在 Windows NT 4.0 上使用。不過，RRAS 可轉散發套件中包含的 Mprapi.dll 版本會將函式導出為 RasAdminConnectionGetInfo ，而不是 MprAdminConnectionGetInfo。因此，使用 RRAS 可轉散發套件時，請使用 LoadLibrary 和 GetProcAddress 來存取此函式。

規格需求

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