ConvertInterfaceAliasToLuid 関数

ConvertInterfaceAliasToLuid 関数は、ネットワーク インターフェイスのインターフェイス エイリアス名を、インターフェイスのローカル一意識別子 (LUID) に変換します。

Note

ConvertInterfaceXxx API ファミリは、TCP/IP にバインドされているすべてのインターフェイスの識別子を列挙します。これには、仮想ミニポート、軽量フィルター、トンネル アダプター、物理インターフェイスが含まれる場合があります。

構文

NETIOAPI_API ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

パラメーター

  • InterfaceAlias [in]
    ネットワーク インターフェイスのエイリアス名を含む NULL で終わる Unicode 文字列へのポインター。

  • InterfaceLuid [out]
    ネットワーク インターフェイスの NET_LUID 共用体へのポインター。

戻り値

ConvertInterfaceAliasToLuid は、関数が成功した場合に STATUS_SUCCESS を返します。 関数が失敗した場合、InterfaceLuid パラメーターは NULL設定され、ConvertInterfaceAliasToLuid は次のエラー コードを返します。

リターン コード 説明
STATUS_INVALID_PARAMETER

パラメーターの 1 つが無効です。 ConvertInterfaceAliasToLuid は、InterfaceAlias または InterfaceLuidNULL の場合、または InterfaceAlias が無効な場合に、このエラーを返します。に、このエラーを返します。

解説

ConvertInterfaceAliasToLuid 関数はプロトコルに依存せず、IPv6 プロトコルと IPv4 プロトコルの両方のネットワーク インターフェイスで動作します。

要件

対象プラットフォーム

ユニバーサル

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダー

Netioapi.h (Netioapi.h を含む)

ライブラリ

Netio.lib

IRQL

PASSIVE_LEVEL

関連項目

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID