MprConfigInterfaceGetHandle 関数 (mprapi.h)

MprConfigInterfaceGetHandle 関数は、指定したルーター構成で、指定したインターフェイスの構成へのハンドルを取得します。

構文

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

[in] hMprConfig

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

[in] lpwsInterfaceName

構成ハンドルが要求されるインターフェイスの名前を指定する 、null で終わる Unicode 文字列へのポインター。 LAN インターフェイスの名前としてインターフェイス GUID を使用します。

[out] phRouterInterface

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

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

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

値	意味
ERROR_INVALID_PARAMETER	hMprConfig パラメーターが NULL であるか、lpwsInterfaceName パラメーターが NULL であるか、両方のパラメーターが NULL です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。
ERROR_NO_SUCH_INTERFACE	指定されたインターフェイスがルーター構成で見つかりませんでした。
その他	FormatMessage を使用して、返されたエラーコードに対応するシステムエラーメッセージを取得します。