функция обратного вызова NDK_FN_GET_LISTENER_LOCAL_ADDRESS (ndkpi.h)

  • Статья

Функция NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) возвращает локальный адрес прослушивателя NDK.

Синтаксис

NDK_FN_GET_LISTENER_LOCAL_ADDRESS NdkFnGetListenerLocalAddress;

NTSTATUS NdkFnGetListenerLocalAddress(
  [in] NDK_LISTENER *pNdkListener,
       PSOCKADDR pAddress,
       ULONG *pAddressLength
)
{...}

Параметры

[in] pNdkListener

Указатель на объект прослушивателя NDK (NDK_LISTENER).

pAddress

В этом буфере возвращается локальный адрес прослушивателя.

pAddressLength

Размер (в байтах) буфера адресов для входных данных и размер в байтах фактического адреса, записанного в буфер для вывода.

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

Функция NdkGetListenerLocalAddress возвращает один из следующих кодов NTSTATUS.

Код возврата Описание
STATUS_SUCCESS
 Локальный адрес был записан в буфер в параметре pAddress .
STATUS_BUFFER_TOO_SMALL
 Размер буфера, указанный во входных данных параметра *pAddressLength , слишком мал. *Выходное значение pAddressLength обновляется с учетом требуемого размера буфера.
Другие коды состояния
 Произошла ошибка.

Комментарии

NdkGetListenerLocalAddress возвращает локальный адрес прослушивателя. Локальный адрес полезен для получения сведений о портах для прослушивателя AF_INET или AF_INET6. Например, если потребитель NDK указывает ноль в качестве номера порта ND в запросе на прослушивание, а поставщик NDK указывает порт, потребитель NDK может использовать NdkGetListenerLocalAddress для определения порта, указанного поставщиком.

Требования

Требование Значение
Минимальная версия клиента Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
Минимальная версия сервера Windows Server 2012
Целевая платформа Windows
Header ndkpi.h (включая Ndkpi.h)
IRQL <=DISPATCH_LEVEL

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

NDK_FN_LISTEN

NDK_LISTENER