ConvertInterfaceLuidToGuid function
ConvertInterfaceGuidToLuid function は、ネットワーク インターフェイスのグローバル一意識別子 (LUID) を、インターフェイスのローカル一意識別子 (GUID) に変換します。
Note
ConvertInterfaceXxx API ファミリは、TCP/IP にバインドされているすべてのインターフェイスの識別子を列挙します。これには、仮想ミニポート、軽量フィルター、トンネル アダプター、物理インターフェイスが含まれる場合があります。
構文
NETIOAPI_API ConvertInterfaceLuidToGuid(
_In_ const NET_LUID *InterfaceLuid,
_Out_ GUID *InterfaceGuid
);
パラメーター
InterfaceLuid [in]
ネットワーク インターフェイスの NET_LUID 共用体へのポインター。InterfaceGuid [out]
ネットワークインターフェイスのGUIDへのポインタ。
戻り値
ConvertInterfaceGuidToLuid は、function が成功した場合に STATUS_SUCCESS を返します。 function が失敗した場合、InterfaceLuid パラメーターは NULL に設定され、ConvertInterfaceGuidToLuid は次のエラー コードを返します。
| リターン コード | 説明 |
|---|---|
| STATUS_INVALID_PARAMETER | パラメーターの 1 つが無効です。 ConvertInterfaceLuidToGuid は、InterfaceLuid または InterfaceGuid が NULL の場合、または InterfaceLuid が無効な場合に、このエラーを返します。 |
解説
ConvertInterfaceGuidToLuid functionはプロトコルに依存せず、IPv6 プロトコルと IPv4 プロトコルの両方のネットワーク インターフェイスで動作します。
要件
対象プラットフォーム |
ユニバーサル |
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Netioapi.h (Netioapi.h を含む) |
ライブラリ |
Netio.lib |
IRQL |
PASSIVE_LEVEL |