NDK_FN_GET_LISTENER_LOCAL_ADDRESS função de retorno de chamada (ndkpi.h)

  • Artigo

A função NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) retorna o endereço local de um ouvinte do NDK.

Sintaxe

NDK_FN_GET_LISTENER_LOCAL_ADDRESS NdkFnGetListenerLocalAddress;

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

Parâmetros

[in] pNdkListener

Um ponteiro para um objeto ouvinte NDK (NDK_LISTENER).

pAddress

Um endereço local para um ouvinte é retornado nesse buffer.

pAddressLength

O tamanho, em bytes, do buffer de endereço para entrada e o tamanho, em bytes, do endereço real gravado no buffer para saída.

Retornar valor

A função NdkGetListenerLocalAddress retorna um dos seguintes códigos NTSTATUS.

Código de retorno Descrição
STATUS_SUCCESS
 Um endereço local foi gravado no buffer no parâmetro pAddress .
STATUS_BUFFER_TOO_SMALL
 O tamanho do buffer especificado na entrada do parâmetro *pAddressLength é muito pequeno. *o valor de saída pAddressLength é atualizado com o tamanho do buffer necessário.
Outros códigos de status
 Ocorreu um erro.

Comentários

NdkGetListenerLocalAddress retorna o endereço local de um ouvinte. O endereço local é útil para recuperar informações de porta para um ouvinte de AF_INET ou AF_INET6. Por exemplo, se o consumidor do NDK especificar zero como o número da porta ND em uma solicitação de escuta e o provedor NDK especificar uma porta, o consumidor do NDK poderá usar NdkGetListenerLocalAddress para determinar qual porta o provedor especificou.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum com suporte, com suporte no NDIS 6.30 e posterior.
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho ndkpi.h (inclua Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Confira também

NDK_FN_LISTEN

NDK_LISTENER