MprAdminServerGetInfo 函式 (mprapi.h)
MprAdminServerGetInfo 函式會擷取指定 RRAS 伺服器的相關信息。
語法
DWORD MprAdminServerGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwLevel,
[out] LPBYTE *lplpbBuffer
);
參數
[in] hMprServer
要查詢的路由器句柄。 藉由呼叫 MprAdminServerConnect 來取得此句柄。
[in] dwLevel
DWORD 值,描述 lplpBuffer 參數中傳回資訊的格式。 dwLevel 可接受的值包括 0、1 和 2,如下表所列。
值 | 結構格式 |
---|---|
0 | Windows 2000 Server 或更新版本: MPR_SERVER_0 |
1 | Windows Server 2003 或更新版本: MPR_SERVER_1 |
2 | Windows Server 2008 或更新版本: MPR_SERVER_2 |
[out] lplpbBuffer
成功完成時,MPR_SERVER_0指標,MPR_SERVER_1
或 MPR_SERVER_2 結構。 dwLevel 參數會指出結構的型別。
使用 MprAdminBufferFree 釋放此緩衝區的記憶體
傳回值
如果函式成功,傳回值 會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
呼叫的應用程式沒有足夠的許可權。 |
|
lplpbBuffer 參數為 NULL。 |
|
hMprServer 參數為 NULL。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | mprapi.h |
程式庫 | Mprapi.lib |
Dll | Mprapi.dll |