MprConfigServerGetInfo 函式 (mprapi.h)

MprConfigServerGetInfo 函式會擷取指定路由器的伺服器層級組態資訊。

語法

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

[in] hMprConfig

路由器組態的句柄。藉由呼叫 MprConfigServerConnect 來取得此句柄。

[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 參數會指出結構的型別。使用 MprConfigBufferFree 釋放此緩衝區的記憶體。

如果函式成功，傳回值 會NO_ERROR。

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

值	意義
ERROR_INVALID_PARAMETER	至少符合下列其中一項條件： hMprConfig 參數為 NULL。 dwLevel 參數不是零。 lplpBuffer 參數為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。