MprAdminMIBEntryGet 函式 (mprapi.h)

發行項
02/29/2024

MprAdminMIBEntryGet 函式會擷取路由通訊協定或路由器管理員所匯出其中一個變數的值。

語法

DWORD MprAdminMIBEntryGet(
  [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。

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

值	Description
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