Função MprAdminGetIpv6AddressForUser (mprapi.h)
RAS chama a função MprAdminGetIpv6AddressForUser uma vez para cada usuário que requer um endereço IPv6. RAS chama a função com o endereço IPv6 selecionado pelo RAS para o usuário. A DLL de terceiros que implementa essa função pode alterar esse endereço para uma de suas próprias escolhas.
Sintaxe
DWORD MprAdminGetIpv6AddressForUser(
[in] WCHAR *lpwszUserName,
[in] WCHAR *lpwszPortName,
[in, out] IN6_ADDR *lpdwIpv6Address,
[out] BOOL *bNotifyRelease
);
Parâmetros
[in] lpwszUserName
Ponteiro para uma cadeia de caracteres Unicode que especifica o nome do usuário que requer um endereço IP.
[in] lpwszPortName
Ponteiro para uma cadeia de caracteres Unicode que especifica o nome da porta na qual o usuário está tentando se conectar.
[in, out] lpdwIpv6Address
Ponteiro para uma estrutura de in6_addr que contém zero ou o RAS de endereço IPv6 alocado para o usuário.
Atualmente, há suporte para apenas identificadores de 64 bits.
Na saída, se RAS tiver especificado zero, a DLL alocará um endereço IPv6 para o usuário. Nesse caso, se a DLL não alocar um endereço IPv6, o usuário não poderá se conectar. Se RAS especificou um endereço IPv6, a DLL aceitará o endereço ou substituirá outro.
[out] bNotifyRelease
Ponteiro para uma variável BOOL . Se a DLL definir essa variável como TRUE, RAS chamará MprAdminReleaseIpv6AddressForUser quando o usuário se desconectar. Caso contrário, RAS não notificará a DLL quando esse endereço IP for liberado.
Valor retornado
Se a função for bem-sucedida, o valor retornado deverá ser NO_ERROR.
Se a função retornar algo diferente de NO_ERROR, o RAS encerrará a conexão.
Comentários
Uma DLL de administração não precisa implementar a função MprAdminGetIpv6AddressForUser . No entanto, se a DLL implementar MprAdminGetIpv6AddressForUser, ela também deverá implementar MprAdminReleaseIpv6AddressForUser.
Requisitos
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mprapi.h |