MprAdminMIBEntryGetNext 函式 (mprapi.h)

發行項
08/24/2023

MprAdminMIBEntryGetNext函式會擷取通訊協定或路由器管理員所匯出之一組變數的下一個變數。服務呼叫的模組會定義 下一個。

語法

DWORD MprAdminMIBEntryGetNext(
  [in]  MIB_SERVER_HANDLE hMibServer,
  [in]  DWORD             dwProtocolId,
  [in]  DWORD             dwRoutingPid,
  [in]  LPVOID            lpInEntry,
  [in]  DWORD             dwInEntrySize,
  [out] LPVOID            *lplpOutEntry,
  [out] LPDWORD           lpOutEntrySize
);

參數

[in] hMibServer

處理要在其中執行此呼叫的路由器。這個控制碼是從先前呼叫 MprAdminMIBServerConnect取得。

[in] dwProtocolId

指定匯出變數的路由器管理員。

[in] dwRoutingPid

指定匯出變數的路由通訊協定。

[in] lpInEntry

不透明資料結構的指標。資料結構的格式是由服務呼叫的模組所決定。資料結構應該包含指定所查詢之變數的資訊。

[in] dwInEntrySize

指定 lpInEntry所指向之資料結構的大小，以位元組為單位。

[out] lplpOutEntry

指標變數的指標。成功傳回時，這個指標變數會指向不透明的資料結構。資料結構的格式是由服務呼叫的模組所決定。資料結構會從匯出的變數集接收下一個變數的值。呼叫 MprAdminMIBBufferFree來釋放此記憶體。

[out] lpOutEntrySize

DWORD變數的指標。此變數會接收透過 lplpOutEntry 參數傳回的資料結構位元組大小。

傳回值

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

如果函式失敗，則傳回值是下列其中一個值。

值	描述
ERROR_ACCESS_DENIED	呼叫端沒有足夠的許可權。
ERROR_CANNOT_COMPLETE	dwRoutingPid變數不符合任何已安裝的路由通訊協定。
ERROR_UNKNOWN_PROTOCOL_ID	dwTransportId值不符合任何已安裝的路由器管理員。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。

備註

請勿傳入lpInEntry參數的Null，因為產生的行為未定義。

需求


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