Поделиться через


Функция AllocateAndGetTcpExTableFromStack (iphlpapi.h)

[Эта функция больше не доступна для использования в Windows Vista. Вместо этого используйте функцию GetTcpTable или GetExtendedTcpTable для получения таблицы подключений TCP.]

Функция AllocateAndGetTcpExTableFromStack извлекает таблицу подключений TCP и выделяет память из локальной кучи для хранения таблицы.

Синтаксис

DWORD AllocateAndGetTcpExTableFromStack(
  [out] PVOID  *ppTcpTable,
  [in]  BOOL   bOrder,
  [in]  HANDLE hHeap,
  [in]  DWORD  dwFlags,
  [in]  DWORD  dwFamily
);

Параметры

[out] ppTcpTable

Указатель на адрес непрозрачных данных, содержащих таблицу tcp-подключений после возврата функции.

[in] bOrder

Если значение равно true, записи подключения TCP в таблице, возвращаемой в ppTcpTable, сортируются; Если значение равно false, они не имеют значения .

[in] hHeap

Дескриптор к куче, из которой будет выделена память для хранения таблицы.

[in] dwFlags

Один или несколько флагов, указывающих определенное поведение элемента управления выделением кучи.

[in] dwFamily

Семейство TCP-адресов в таблице.

Значение Значение
AF_INET
Получение TCP-адресов IPv4.
AF_INET6
Получение TCP-адресов IPv6.

Возвращаемое значение

Если функция выполняется успешно, она возвращает ERROR_SUCCESS.

Если функция завершается сбоем, она возвращает функцию из winerror.h.

Комментарии

В microsoft пакет средств разработки программного обеспечения для Windows (SDK), выпущенном для Windows Vista и более поздних версий, прототип функции Для AllocateAndGetTcpExTableFromStack по-прежнему определен в файле заголовка Iphlpapi.h для дальнейшей поддержки в Windows Server 2003 и Windows XP.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header iphlpapi.h
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

См. также раздел

AllocateAndGetUdpExTableFromStack

GetExtendedTcpTable

GetTcpTable