ConvertInterfaceIndexToLuid 関数 (netioapi.h)

[アーティクル]
03/13/2024

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

構文

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

パラメーター

[in] InterfaceIndex

ネットワークインターフェイスのローカルインデックス値。

[out] InterfaceLuid

このインターフェイスの NET_LUID へのポインター。

戻り値

成功すると、 ConvertInterfaceIndexToLuid はNO_ERRORを返します。 0 以外の戻り値は失敗を示し、InterfaceLuid パラメーターで NULL が返されます。

エラーコード	意味
ERROR_FILE_NOT_FOUND	指定されたファイルが見つかりません。 InterfaceIndex パラメーターで指定されたネットワークインターフェイスがローカルコンピューター上の値ではない場合、このエラーが返されます。
ERROR_INVALID_PARAMETER	1 つのパラメーターが無効です。このエラーは、 InterfaceLuid パラメーターが NULL の場合、または InterfaceIndex パラメーターが無効な場合に返されます。

注釈

ConvertInterfaceIndexToLuid 関数は、Windows Vista 以降で使用できます。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	netioapi.h (Iphlpapi.h を含む)
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll