關於 RAS 伺服器和埠管理

RAS 伺服器管理功能會取得指定 RAS 伺服器及其埠的相關資訊。 這些函式也可用來終止指定 RAS 伺服器埠上的連線。

MprAdminServerGetInfo函式會傳回MPR_SERVER_0結構，其中包含 RAS 伺服器設定的相關資訊。 傳回的資訊包括目前可用於連線的埠數目、目前使用的埠數目，以及伺服器版本號碼。

MprAdminPortEnum函式會擷取RAS_PORT_0結構的陣列。 每個結構都包含在 RAS 伺服器上設定的其中一個埠資訊。 每個埠的資訊包括：

• 埠的名稱
• 連結至埠之裝置的相關資訊
• 與埠相關聯的 RAS 伺服器是否為 Windows NT/Windows 2000 伺服器
• 埠目前是否正在使用中，如果為 ，則為連線的相關資訊

若要取得特定連線所使用的埠，請在hConnection參數中傳遞MprAdminPortEnum該連線的控制碼。 若要取得連線的控制碼，請使用 MprAdminConnectionEnum 函式。 或者，如果您已實作 RAS 系統管理 DLL， MprAdminAcceptNewConnection 和 MprAdminAcceptNewConnection2 函式會在建立連線時收到每個新連線的控制碼。

您可以呼叫 MprAdminPortGetInfo 函式，以取得 RAS 伺服器上指定埠的其他資訊。 此函式會傳回 RAS_PORT_1 結構，其中包含 RAS_PORT_0 結構和埠目前狀態的其他資訊。 RasAdminPortGetInfo函式也會傳回RAS_PARAMETERS結構的陣列，描述與埠相關聯的任何媒體特定索引鍵的值。 RAS_PARAMETERS結構會使用來自 RAS_PARAMS_FORMAT列舉的值來指出每個媒體特定索引鍵的值格式。

MprAdminPortGetInfo函式也會傳回RAS_PORT_STATISTICS結構，其中包含埠上目前連接的各種統計資料計數器。 對於屬於多連結連線一部分的埠， MprAdminPortGetInfo 會傳回個別埠的統計資料，以及連接中涉及之所有埠的累積統計資料。 您可以使用 MprAdminPortClearStats 函式來重設埠的統計資料計數器。 MprAdminPortDisconnect函式會中斷使用中的埠連線。

使用 MprAdminBufferFree 函式來釋放 MprAdminPortEnum 和 MprAdminPortGetInfo 函 式所配置的記憶體。 使用 MprAdminGetErrorString 函式來取得字串，描述 RAS 伺服器管理 (RasAdmin) 函式所傳回的 RAS 錯誤碼。