Compartir a través de


NDK_FN_GET_LISTENER_LOCAL_ADDRESS función de devolución de llamada (ndkpi.h)

La función NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) devuelve la dirección local de un agente de escucha NDK.

Sintaxis

NDK_FN_GET_LISTENER_LOCAL_ADDRESS NdkFnGetListenerLocalAddress;

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

Parámetros

[in] pNdkListener

Puntero a un objeto de agente de escucha NDK (NDK_LISTENER).

pAddress

En este búfer se devuelve una dirección local para un agente de escucha.

pAddressLength

Tamaño, en bytes, del búfer de direcciones para la entrada y el tamaño, en bytes, de la dirección real escrita en el búfer para la salida.

Valor devuelto

La función NdkGetListenerLocalAddress devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
Se escribió una dirección local en el búfer en el parámetro pAddress de.
STATUS_BUFFER_TOO_SMALL
El tamaño del búfer especificado en el entrada de parámetro *pAddressLength es demasiado pequeño. valor de salida *pAddressLength se actualiza con el tamaño de búfer necesario.
otros códigos de estado
Error.

Observaciones

NdkGetListenerLocalAddress devuelve la dirección local de un agente de escucha. La dirección local es útil para recuperar información de puerto para un agente de escucha de AF_INET o AF_INET6. Por ejemplo, si el consumidor de NDK especifica cero como número de puerto ND en una solicitud de escucha y el proveedor NDK especifica un puerto, el consumidor de NDK puede usar NdkGetListenerLocalAddress para determinar qué puerto especificó el proveedor.

Requisitos

Requisito Valor
cliente mínimo admitido Ninguna compatible, compatible con NDIS 6.30 y versiones posteriores.
servidor mínimo admitido Windows Server 2012
de la plataforma de destino de Windows
encabezado de ndkpi.h (incluya Ndkpi.h)
irQL <=DISPATCH_LEVEL

Consulte también

NDK_FN_LISTEN

NDK_LISTENER