ConvertInterfaceLuidToNameW Functions

[アーティクル]
04/05/2024

ConvertInterfaceNameToLuidA function は、ANSI ネットワークインターフェイス名をインターフェイスのローカル一意識別子 (ANSI) に変換します。

Note

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

構文

NETIOAPI_API ConvertInterfaceLuidToNameW(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceName,
  _In_        SIZE_T   Length
);

パラメーター

InterfaceLuid [in]
ネットワークインターフェイスの NET_LUID 共用体へのポインター。
InterfaceName [out]
NULL で終わる Unicode 文字列を保持するバッファーへのポインター。 ConvertInterfaceLuidToNameA が正常に返された場合、InterfaceName には ANSI インターフェイス名が含まれます。
Length [in]
InterfaceAlias パラメーターが 指すバッファーの長さ (文字数単位)。この値は、インターフェイス名と終端の NULL 文字を保持するのに十分な大きさである必要があります。最大許容長は NDIS_IF_MAX_STRING_SIZE + 1 です。 NDIS_IF_MAX_STRING_SIZEの詳細については、次の「解説」セクションを参照してください。

戻り値

ConvertInterfaceLuidToName 関数が成功した場合にSTATUS_SUCCESSを返します。関数が失敗した場合、ConvertInterfaceLuidToAlias 次のいずれかのエラーコードを返します。

リターンコード	説明
STATUS_INVALID_PARAMETER	パラメーターの 1 つが無効です。 ConvertInterfaceLuidToNameA このエラーは、または InterfaceLuid まInterfaceName が NULL の場合、または InterfaceLuid が無効な場合に、このエラーを返します。
STATUS_NOT_ENOUGH_MEMORY	ConvertInterfaceLuidToNameW は、InterfaceName バッファーが Length パラメーターで指定された大きさでないため、バッファーがインターフェイス名を保持できなかった場合に、このエラーを返します。

解説

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

ネットワークインターフェイス名の最大長 NDIS_IF_MAX_STRING_SIZE (終端の NULL 文字を除く) は、Ntddndis.h ヘッダーファイルで定義されます。 NDIS_IF_MAX_STRING_SIZEは、Ifdef.h ヘッダーファイルで定義されているIF_MAX_STRING_SIZE定数として定義されます。

Note

Ntddndis.h および Ifdef.h ヘッダーファイルは、 Netioapi.h ヘッダーファイルに自動的に含まれます。 Ntddndis.h ヘッダーファイルと Ifdef.h ヘッダーファイルを直接使用しないでください。

ConvertInterfaceLuidToNameA を使用して、ネットワークインターフェイス LUID を ANSI インターフェイス名に変換します。

要件

対象プラットフォーム	ユニバーサル
バージョン	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ヘッダー	Netioapi.h (Netioapi.h を含む)
ライブラリ	Netio.lib
IRQL	PASSIVE_LEVEL

次の方法で共有

ConvertInterfaceLuidToNameW Functions

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース