MprConfigInterfaceEnum 函式 (mprapi.h)

MprConfigInterfaceEnum 函式會列舉為路由器設定的介面。

語法

DWORD MprConfigInterfaceEnum(
  [in]                HANDLE  hMprConfig,
  [in]                DWORD   dwLevel,
  [in, out]           LPBYTE  *lplpBuffer,
  [in]                DWORD   dwPrefMaxLen,
  [out]               LPDWORD lpdwEntriesRead,
  [out]               LPDWORD lpdwTotalEntries,
  [in, out, optional] LPDWORD lpdwResumeHandle
);

參數

[in] hMprConfig

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

[in] dwLevel

DWORD 值，描述 lplpBuffer 參數中傳回資訊的格式。 必須為零。

[in, out] lplpBuffer

在輸入上，非 NULL 指標。

成功完成時， 指向MPR_INTERFACE_0 結構的陣列指標。 呼叫 MprConfigBufferFree 以釋放此記憶體緩衝區。

[in] dwPrefMaxLen

以8位位元組 () 指定所傳回數據的慣用最大長度) 。 如果此參數為 -1，傳回的緩衝區會夠大，足以保存所有可用的資訊。

[out] lpdwEntriesRead

DWORD 變數的指標。 此變數會接收從目前繼續位置列舉的項目總數。

[out] lpdwTotalEntries

DWORD 變數的指標。 此變數會接收可能已從目前繼續位置列舉的項目總數。

[in, out, optional] lpdwResumeHandle

DWORD 變數的指標。

在輸入時，句柄應該在第一次呼叫時為零，並在後續呼叫上保持不變以繼續列舉。

在輸出中，包含可用來繼續列舉的繼續句柄。 如果句柄為 NULL，則列舉已完成。

如果列舉中發生錯誤，這個句柄會無效。

這是選擇性參數。 如果呼叫應用程式指定此參數的 NULL ，函式不會傳回繼續句柄。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	以下其中一項為正確： hMprConfig 為 NULL。 dwLevel 不是零。 lplpBuffer 為 NULL。 dwPrefMaxLen 小於單一 MPR_INTERFACE_0 結構的大小。 lpdwEntriesRead 為 NULL。 lpdwTotalEntries 為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NO_MORE_ITEMS	目前繼續位置不再提供任何專案。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	mprapi.h
程式庫	Mprapi.lib
Dll	Mprapi.dll

另請參閱

FormatMessage

MprConfigBufferFree

MprConfigServerConnect

路由器設定函式

路由器管理參考