MprAdminMIBEntryGetFirst 関数 (mprapi.h)

[アーティクル]
03/05/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。

関数が失敗した場合、戻り値は次のいずれかの値になります。

値	説明
ERROR_ACCESS_DENIED	呼び出し元に十分な特権がありません。
ERROR_CANNOT_COMPLETE	dwRoutingPid 変数は、インストールされているルーティングプロトコルと一致しません。
ERROR_UNKNOWN_PROTOCOL_ID	dwTransportId 値は、インストールされているトランスポート/ルーターマネージャーと一致しません。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。

注釈

結果の動作は未定義であるため、lpInEntry パラメーターに NULL を渡さないでください。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mprapi.h
Library	Mprapi.lib
[DLL]	Mprapi.dll