NhpAllocateAndGetInterfaceInfoFromStack 関数 (iphlpapi.h)

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

[この関数は、Windows Vista の時点では使用できなくなりました。代わりに、 GetAdaptersAddresses 関数と、関連付けられている IP_ADAPTER_ADDRESSES 構造体を使用します。

NhpAllocateAndGetInterfaceInfoFromStack 関数は、ローカルコンピューターに関するアダプター情報を取得します。

構文

IPHLPAPI_DLL_LINKAGE DWORD NhpAllocateAndGetInterfaceInfoFromStack(
  IP_INTERFACE_NAME_INFO **ppTable,
  PDWORD                 pdwCount,
  BOOL                   bOrder,
  HANDLE                 hHeap,
  DWORD                  dwFlags
);

パラメーター

ppTable

ローカルシステム上の各アダプターに関する情報を含むIP_INTERFACE_NAME_INFO構造体の配列。配列には、システム上のアダプターごとに 1 つの要素が含まれています。

pdwCount

ppTable 配列内の要素の数。

bOrder

TRUE の場合、ppTable 配列の要素はインデックス値を増やして並べ替えられます。

hHeap

ppTable を割り当てるヒープを指定するハンドル。このパラメーターには、 GetProcessHeap 関数の呼び出しによって返されるプロセスヒープ、または HeapCreate 関数の呼び出しによって作成されたプライベートヒープを指定できます。

dwFlags

ppTable のメモリを割り当てるときに HeapAlloc 関数に渡されるフラグのセット。詳細については、 HeapAlloc 関数を参照してください。

戻り値

正常に完了したときにERROR_SUCCESSを返します。

注釈

Microsoft Windows ソフトウェア開発キット (Windows SDK) (SDK) では、NhpAllocateAndGetInterfaceInfoFromStack 関数が Windows 2000 Service Pack 1 (SP1) 以降で定義されています。アプリケーションをコンパイルするときに、ターゲットプラットフォームが SP1 以降の Windows 2000 (NTDDI_VERSION >= NTDDI_WIN2KSP1、、 _WIN32_WINNT >= 0x0500または WINVER >= 0x0500) の場合、 NhpAllocateAndGetInterfaceInfoFromStack が定義されます。

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional SP1 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003、Windows 2000 Server SP1 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	iphlpapi.h
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll