mprAdminMIBEntryGetFirst 函式 (mprapi.h)

發行項
02/29/2024

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

語法

DWORD MprAdminMIBEntryGetFirst(
  [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