NhpAllocateAndGetInterfaceInfoFromStack 関数 (iphlpapi.h)
[この関数は、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 |