RasAdminPortGetInfo 函式
[此函式僅適用于與 server 4.0 Windows NT的回溯相容性。 它會在 Windows Server 2003 上傳回ERROR_CALL_NOT_IMPLEMENTED。 應用程式應該使用 MprAdminPortGetInfo 函式。]
RasAdminPortGetInfo函式會擷取指定伺服器上指定埠的相關資訊。
語法
DWORD RasAdminPortGetInfo(
_In_ const WCHAR *lpszServer,
_In_ const WCHAR *lpszPort,
_Out_ RAS_PORT_1 *pRasPort1,
_Out_ RAS_PORT_STATISTICS *pRasStats,
_Out_ RAS_PARAMETERS **ppRasParams
);
參數
-
lpszServer [in]
-
指定 RAS 伺服器名稱之 Null 終止 Unicode 字串的指標。 以 \\servername格式指定具有前置 「\\」 字元的名稱。
-
lpszPort [in]
-
指定伺服器上端口名稱的 Null 終止 Unicode 字串指標。
-
pRasPort1 [out]
-
函式填入埠狀態相關資訊的 RAS_PORT_1 結構指標。
-
pRasStats [out]
-
函式填入埠統計資料之 RAS_PORT_STATISTICS 結構的指標。
-
ppRasParams [out]
-
接收 RAS_PARAMETERS 結構陣列之位址的指標變數指標。 每個結構都包含媒體特定索引鍵的名稱，例如 MAXCONNECTBPS 及其相關聯的值。 當應用程式完成此記憶體時，請呼叫 RasAdminFreeBuffer 函式來釋放它。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值可以是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
指定的埠無效。 |
|
記憶體不足，無法配置 ppRasParams 陣列的緩衝區。 |
此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。
規格需求
| 需求 | 值 |
|---|---|
| 用戶端支援結束 |
Windows 2000 Professional |
| 伺服器終止支援 |
Windows 2000 Server |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|