Compartilhar via


Função NotifyTeredoPortChange (netioapi.h)

A função NotifyTeredoPortChange registra para ser notificada quanto a alterações no número da porta UDP usado pelo cliente Teredo para a porta de serviço teredo em um computador local.

Sintaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyTeredoPortChange(
  [in]      PTEREDO_PORT_CHANGE_CALLBACK Callback,
  [in]      PVOID                        CallerContext,
  [in]      BOOLEAN                      InitialNotification,
  [in, out] HANDLE                       *NotificationHandle
);

Parâmetros

[in] Callback

Um ponteiro para a função a ser chamada quando ocorre uma alteração de porta do cliente Teredo. Essa função será invocada quando uma notificação de alteração de porta teredo for recebida.

[in] CallerContext

Um contexto de usuário passado para a função de retorno de chamada especificada no parâmetro Callback quando uma notificação de alteração de porta teredo é recebida.

[in] InitialNotification

Um valor que indica se o retorno de chamada deve ser invocado imediatamente após a conclusão do registro da notificação de alteração. Essa notificação inicial não indica que ocorreu uma alteração na porta do cliente Teredo. A finalidade desse parâmetro para fornecer a confirmação de que o retorno de chamada está registrado.

[in, out] NotificationHandle

Um ponteiro usado para retornar um identificador que pode ser usado posteriormente para desregistrar a notificação de alteração. Em caso de êxito, um identificador de notificação é retornado nesse parâmetro. Se ocorrer um erro, NULL será retornado.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_INVALID_HANDLE
Ocorreu um erro interno em que um identificador inválido foi encontrado.
ERROR_INVALID_PARAMETER
Um parâmetro inválido foi passado para a função. Esse erro será retornado se o parâmetro Callback for um ponteiro NULL .
ERROR_NOT_ENOUGH_MEMORY
Não havia memória suficiente.
Outros
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função NotifyTeredoPortChange é definida no Windows Vista e posterior.

A função GetTeredoPort pode ser usada para recuperar o número da porta UDP inicial usado pelo cliente Teredo para a porta de serviço do Teredo.

A porta Teredo é dinâmica e pode mudar sempre que o cliente Teredo é reiniciado no computador local. Um aplicativo pode se registrar para ser notificado quando a porta de serviço do Teredo for alterada chamando a função NotifyTeredoPortChange .

A invocação da função de retorno de chamada especificada no parâmetro Callback é serializada. A função de retorno de chamada deve ser definida como uma função do tipo VOID. Os parâmetros passados para a função de retorno de chamada incluem o seguinte:

Parâmetro Descrição
IN PVOID CallerContext O parâmetro CallerContext passado para a função NotifyTeredoPortChange ao se registrar para notificações.
Na porta USHORT O número da porta UDP usado atualmente pelo cliente Teredo. Esse parâmetro é zero quando o valor MIB_NOTIFICATION_TYPE passado no parâmetro NotificationType para a função de retorno de chamada é definido como MibInitialNotification. Isso só poderá ocorrer se o parâmetro InitialNotification passado para NotifyTeredoPortChange tiver sido definido como TRUE ao se registrar para notificações.
IN MIB_NOTIFICATION_TYPE NotificationType O tipo de notificação. Esse membro pode ser um dos valores do tipo de enumeração MIB_NOTIFICATION_TYPE definido no arquivo de cabeçalho Netioapi.h .
 

A função de retorno de chamada especificada no parâmetro Callback deve ser implementada no mesmo processo que o aplicativo que chama a função NotifyTeredoPortChange . Se a função de retorno de chamada estiver em uma DLL separada, a DLL deverá ser carregada antes de chamar a função NotifyTeredoPortChange para se registrar para notificações de alteração.

Depois que a função NotifyTeredoPortChange for chamada para se registrar para notificações de alteração, essas notificações continuarão a ser enviadas até que os desregistros do aplicativo para notificações de alteração ou o aplicativo seja encerrado. Se o aplicativo for encerrado, o sistema cancelará automaticamente qualquer registro para notificações de alteração. Ainda é recomendável que um aplicativo desregistre explicitamente para notificações de alteração antes de ser encerrado.

Qualquer registro de notificações de alteração não persiste em um sistema desligado ou reinicializado.

Para cancelar o registro de notificações de alteração, chame a função CancelMibChangeNotify2 passando o parâmetro NotificationHandle retornado por NotifyTeredoPortChange.

Um aplicativo não pode fazer uma chamada para a função CancelMibChangeNotify2 do contexto do thread que está executando atualmente a função de retorno de chamada de notificação para o mesmo parâmetro NotificationHandle . Caso contrário, o thread que executa esse retorno de chamada resultará em deadlock. Portanto, a função CancelMibChangeNotify2 não deve ser chamada diretamente como parte da rotina de retorno de chamada de notificação. Em uma situação mais geral, um thread que executa a função CancelMibChangeNotify2 não pode ter um recurso no qual o thread que executa uma operação de retorno de chamada de notificação aguardaria porque resultaria em um deadlock semelhante. A função CancelMibChangeNotify2 deve ser chamada de um thread diferente, no qual o thread que recebe o retorno de chamada de notificação não tem dependências.

O cliente Teredo também usa a porta UDP estática 3544 para escutar o tráfego multicast enviado no endereço IPv4 multicast 224.0.0.253, conforme definido no RFC 4380. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc4380.txt.

A função NotifyTeredoPortChange é usada principalmente por aplicativos de firewall para configurar as exceções apropriadas para permitir o tráfego Teredo de entrada e saída.

A função NotifyStableUnicastIpAddressTable é usada principalmente por aplicativos que usam o cliente Teredo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho netioapi.h (inclua Iphlpapi.h)
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também

CancelMibChangeNotify2

GetTeredoPort

NotifyStableUnicastIpAddressTable