if_indextoname関数 (netioapi.h)

[アーティクル]
02/29/2024

if_indextoname関数は、ネットワークインターフェイスのローカルインデックスを ANSI インターフェイス名に変換します。

構文

IPHLPAPI_DLL_LINKAGE PCHAR NETIOAPI_API_ if_indextoname(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PCHAR       InterfaceName
);

パラメーター

[in] InterfaceIndex

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

[out] InterfaceName

関数が正常に返されたときにインターフェイス名を含む NULL で終わる ANSI 文字列を保持するバッファーへのポインター。このパラメーターが指すバッファーの長さ (バイト単位) は、 IF_NAMESIZE以上である必要があります。

戻り値

成功 した場合、if_indextoname はインターフェイス名を含む NULL で終わる ANSI 文字列へのポインターを返します。失敗した場合は、 NULL ポインターが返されます。

注釈

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

if_indextoname関数は、インターフェイスインデックスを対応する名前にマップします。この関数は、RFC 2553 の IETF で説明されているように、IPv6 の基本的なソケット拡張機能の一部として設計されています。詳細については、「http://www.ietf.org/rfc/rfc2553.txt」を参照してください。

if_indextoname関数は、Unix 環境でのアプリケーションの移植性を実現するために実装されていますが、ConvertInterface 関数を使用することをお勧めします。 if_indextoname関数を ConvertInterfaceIndexToLuid 関数の呼び出しに置き換えて、インターフェイスインデックスをNET_LUIDに変換し、その後に ConvertInterfaceLuidToNameA を呼び出して、NET_LUIDを ANSI インターフェイス名に変換できます。

if_indextonameが失敗し、NULL ポインターを返した場合、エラーコードを特定することはできません。

InterfaceName パラメーターが指すバッファーの長さ (バイト単位) は、netioapi.h ヘッダーファイルで宣言された値IF_NAMESIZEと等しいか、NDIS_IF_MAX_STRING_SIZE以上である必要があります。インターフェイス名の最大長 (終端の NULL を除くNDIS_IF_MAX_STRING_SIZE) は、Ntddndis.h ヘッダーファイルで宣言されています。 NDIS_IF_MAX_STRING_SIZEは、Ifdef.h ヘッダーファイルで定義されているIF_MAX_STRING_SIZE定数として定義されます。 Ntddndis.h ヘッダーファイルと Ifdef.h ヘッダーファイルは、Iphlpapi.h ヘッダーファイルによって自動的に含まれる Netioapi.h ヘッダーファイルに自動的に含まれます。 Ntddndis.h、Ifdef.h、および Netioapi.h ヘッダーファイルを直接使用しないでください。

要件

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