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

Confira também

MprAdminReleaseIpv6AddressForUser

DLL de Administração ras

Funções de administração ras

Referência de administração do serviço de acesso remoto