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
标头 ndkpi.h (包括 Ndkpi.h)
IRQL <=DISPATCH_LEVEL

另请参阅

NDK_FN_LISTEN

NDK_LISTENER