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

  • Artículo

La función NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) devuelve la dirección local de un agente de escucha de 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 escucha de NDK (NDK_LISTENER).

pAddress

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

pAddressLength

El 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 .
STATUS_BUFFER_TOO_SMALL
 El tamaño del búfer especificado en la entrada del parámetro *pAddressLength es demasiado pequeño. *el valor de salida pAddressLength se actualiza con el tamaño de búfer necesario.
Otros códigos de estado
 Se produjo un error.

Comentarios

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 de NDK especifica un puerto, el consumidor de NDK puede usar NdkGetListenerLocalAddress para determinar qué puerto especificó el proveedor.

Requisitos

Requisito Value
Cliente mínimo compatible Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible Windows Server 2012
Plataforma de destino Windows
Encabezado ndkpi.h (incluya Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Consulte también

NDK_FN_LISTEN

NDK_LISTENER