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 |
|---|---|
|
Ocorreu um erro interno em que um identificador inválido foi encontrado. |
|
Um parâmetro inválido foi passado para a função. Esse erro será retornado se o parâmetro Callback for um ponteiro NULL . |
|
Não havia memória suficiente. |
|
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 |