MprAdminInterfaceCreate 関数 (mprapi.h)
MprAdminInterfaceCreate 関数は、指定したサーバーにインターフェイスを作成します。
構文
DWORD MprAdminInterfaceCreate(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer,
[out] HANDLE *phInterface
);
パラメーター
[in] hMprServer
この呼び出しを実行するルーターを処理します。 MprAdminServerConnect を呼び出して、このハンドルを取得します。
[in] dwLevel
lpBuffer パラメーターで情報が構造化される形式を表す 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] phInterface
HANDLE 変数へのポインター。 変数は、このインターフェイスを管理するために後続のすべての呼び出しで使用するハンドルを受け取ります。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 説明 |
|---|---|
|
呼び出し元のアプリケーションに十分な特権がありません。 |
|
ダイナミック インターフェイス マネージャーは LAN でのみ実行するように構成されているため、ルーター インターフェイスの種類はサポートされていません。 |
|
同じ名前のインターフェイスが既に存在します。 |
|
操作を完了するためのリソースが不足しています。 |
|
dwLevel 値が無効です。 |
解説
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 |