MprConfigFilterGetInfo 函式 (mprapi.h)

MprConfigFilterGetInfo函式會傳回指定傳輸通訊協定類型的靜態篩選資訊。

語法

DWORD MprConfigFilterGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  DWORD  dwTransportId,
  [out] LPBYTE lpBuffer
);

[in] hMprConfig

路由器組態的控制碼。藉由呼叫 MprConfigServerConnect來取得此控制碼。

[in] dwLevel

DWORD值，描述lpBuffer參數中傳回信息的格式。必須為零。

[in] dwTransportId

DWORD值，描述lpBuffer參數中靜態篩選資訊的傳輸通訊協定類型。下表列出 dwTransportId 可接受的值。

值	傳輸 (通訊協定系列)
PID_ATALK	AppleTalk
PID_IP	網際網路通訊協定第 4 版
PID_IPX	網際網路封包交換
PID_NBF	NetBIOS 框架通訊協定
PID_IPV6	Windows Server 2008 或更新版本：網際網路通訊協定第 6 版

[out] lpBuffer

成功完成時，包含篩選驅動程式組態資訊的 MPR_FILTER_0 結構的指標。呼叫 MprConfigBufferFree來釋放此記憶體緩衝區。

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

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

傳回碼	描述
ERROR_INVALID_PARAMETER	hMprConfig 或 lpBuffer 為 Null，或 dwLevel 未設定為 0。