MprConfigInterfaceGetInfo 関数 (mprapi.h)
MprConfigInterfaceGetInfo 関数は、ルーターから指定されたインターフェイスの構成を取得します。
構文
DWORD MprConfigInterfaceGetInfo(
[in] HANDLE hMprConfig,
[in] HANDLE hRouterInterface,
[in] DWORD dwLevel,
[in, out] LPBYTE *lplpBuffer,
[out] LPDWORD lpdwBufferSize
);
パラメーター
[in] hMprConfig
ルーター構成を処理します。 MprConfigServerConnect を呼び出して、このハンドルを取得します。
[in] hRouterInterface
情報を取得するインターフェイス構成を処理します。 MprConfigInterfaceCreate、MprConfigInterfaceGetHandle、または MprConfigInterfaceEnum を呼び出して、このハンドルを取得します。
[in] dwLevel
lplpBuffer パラメーターで情報が返される形式を表す DWORD 値。 dwLevel に使用できる値は、次の表に示すように、0、1、2、3 です。
| 値 | 構造体の形式 |
|---|---|
| 0 | MPR_INTERFACE_0 |
| 1 | MPR_INTERFACE_1 |
| 2 | MPR_INTERFACE_2 |
| 3 | Windows Server 2008 以降: MPR_INTERFACE_3 |
[in, out] lplpBuffer
入力時に NULL 以外のポインター。
正常に完了すると、MPR_INTERFACE_0の配列へのポインターがMPR_INTERFACE_1。
MPR_INTERFACE_2、または MPR_INTERFACE_3 構造体。 dwLevel パラメーターは、構造体の種類を示します。
MprConfigBufferFree を呼び出して、このバッファーを解放します。
[out] lpdwBufferSize
DWORD 変数へのポインター。 この変数は、 lplpBuffer を介して返されるデータのサイズ (バイト単位) を受け取ります。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 説明 |
|---|---|
|
以下のうち少なくとも 1 つが true です。
|
|
操作を完了するためのリソースが不足しています。 |
|
hRouterInterface に対応するインターフェイスがルーター構成に存在しません。 |
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mprapi.h |
| Library | Mprapi.lib |
| [DLL] | Mprapi.dll |