次の方法で共有

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 です。
  • hMprConfig が NULL です
  • dwLevel が 0、1、2、または 3 ではありません。
  • lpbBuffer が NULL です
  • phRouterInterface が NULL です
ERROR_NOT_ENOUGH_MEMORY
 操作を完了するためのリソースが不足しています。
その他
 FormatMessage を使用して、返されたエラー コードに対応するシステム エラー メッセージを取得します。

解説

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

要件

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

関連項目

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

ルーター構成関数

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