MprAdminConnectionEnumEx 函式 (mprapi.h)
MprAdminConnectionEnumEx 函式會列舉指定 RRAS 伺服器的作用中連線。
語法
DWORD MprAdminConnectionEnumEx(
[in] RAS_SERVER_HANDLE hRasServer,
[in] PMPRAPI_OBJECT_HEADER pObjectHeader,
[in] DWORD dwPreferedMaxLen,
[out] LPDWORD lpdwEntriesRead,
[out] LPDWORD lpdwTotalEntries,
[out] PRAS_CONNECTION_EX *ppRasConn,
[in] LPDWORD lpdwResumeHandle
);
參數
[in] hRasServer
列舉連接之 RAS 伺服器的句柄。 呼叫 MprAdminServerConnect 以取得此句柄。
[in] pObjectHeader
MPRAPI_OBJECT_HEADER 結構的指標，指定 ppRasConn 所收到的結構版本。
[in] dwPreferedMaxLen
值，指定8位位元組中傳回數據的慣用最大長度。 如果 dwPrefMaxLen 為 -1，傳回的緩衝區就足以保存所有可用的資訊。
[out] lpdwEntriesRead
DWORD 的指標，可接收從目前繼續位置列舉的連線總數。
[out] lpdwTotalEntries
DWORD 的指標，接收可能從目前繼續位置列舉的連線總數。
[out] ppRasConn
輸出上的指標，指向包含 hRasServer 中 RRAS 伺服器作用中連接資訊的RAS_CONNECTION_EX結構陣列。 陣列元素的數目取決於 lpdwEntriesRead 所指向的值。
[in] lpdwResumeHandle
DWORD 變數的指標，指定用來繼續列舉的繼續句柄。 第一次呼叫時 ，lpdwResumeHandle 參數為 NULL ，後續呼叫時會保持不變。 如果傳回碼 ERROR_MORE_DATA，可能會使用此句柄來擷取更多數據。 如果句柄在傳回時為 NULL ，列舉就會完成。 這個句柄對其他類型的錯誤傳回無效。
傳回值
如果函式成功，傳回值會 NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
呼叫的應用程式沒有足夠的許可權。 |
|
要求撥號管理員 (DDM) 未執行。 |
|
並非所有的數據都是透過這個呼叫傳回。 若要取得其他數據，請使用繼續句柄再次呼叫 函式。 |
|
找不到指定的程式。 |
|
MprError.h、RasError.h 或 WinError.h 的錯誤。 |
備註
呼叫端應該呼叫 MprAdminBufferFree，以釋放 ppRasConn 指向的記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mprapi.h |
| 程式庫 | Mprapi.lib |
| Dll | Mprapi.dll |