次の方法で共有


MprConfigInterfaceCreate 関数 (mprapi.h)

MprConfigInterfaceCreate 関数は、指定されたルーター構成でルーター インターフェイスを作成します。

構文

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

パラメーター

[in] hMprConfig

ルーター構成を処理します。 MprConfigServerConnect を呼び出して、このハンドルを取得します。

[in] dwLevel

lpbBuffer パラメーターで情報を構造化する形式を表す 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] lpbBuffer

MPR_INTERFACE_0へのポインター、MPR_INTERFACE_1
MPR_INTERFACE_2、または MPR_INTERFACE_3 構造体。 dwLevel パラメーターは、構造体の種類を示します。

[out] phRouterInterface

ハンドル変数へのポインター。 この変数は、インターフェイス構成へのハンドルを受け取ります。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

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

説明
ERROR_INVALID_PARAMETER
以下のうち少なくとも 1 つが true です。
  • hMprConfigNULL です
  • dwLevel が 0、1、2、または 3 ではありません。
  • lpbBufferNULL です
  • phRouterInterfaceNULL です
ERROR_NOT_ENOUGH_MEMORY
操作を完了するためのリソースが不足しています。
その他
FormatMessage を使用して、返されたエラー コードに対応するシステム エラー メッセージを取得します。

解説

MprAdminInterfaceCreate 関数は、MPR_INTERFACE_2構造体をサポートしています。 ただし、 MprConfigInterfaceCreate では実行されません。 再起動後に永続的な需要ダイヤル インターフェイスを作成するには、MPR_INTERFACE_2を使用して MprAdminInterfaceCreate を呼び出し、MPR_INTERFACE_0またはMPR_INTERFACE_1MprConfigInterfaceCreate を呼び出します。

要件

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

関連項目

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

ルーター構成関数

ルーター管理リファレンス