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。

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

值	意義
ERROR_DEV_NOT_EXIST	指定的埠無效。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法配置 ppRasParams 陣列的緩衝區。

此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。

規格需求

需求	值
用戶端支援結束	Windows 2000 Professional
伺服器終止支援	Windows 2000 Server
標頭	Rassapi.h
程式庫	Rassapi.lib
DLL	Rassapi.dll

另請參閱

遠端存取服務 (RAS) 概觀

RAS 伺服器管理功能

RAS_PARAMETERS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminFreeBuffer