Função MprAdminGetIpAddressForUser (mprapi.h)

RAS chama a função MprAdminGetIpAddressForUser uma vez para cada usuário que requer um endereço IP. RAS chama a função com o endereço IP 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 MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [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] lpdwIpAddress

Na entrada, ponteiro para uma variável DWORD que contém zero ou o RAS de endereço IP alocado para o usuário.

Na saída, se RAS tiver especificado zero, a DLL alocará um endereço IP para o usuário. Nesse caso, se a DLL não alocar um endereço IP, o usuário não poderá se conectar. Se RAS tiver especificado um endereço IP, 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á MprAdminReleaseIpAddress 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

O RAS dá suporte a várias DLLs de Administração. No entanto, RAS chama MprAdminGetIpAddressForUser apenas na primeira DLL que implementa e exporta. RAS ignora implementações dessas funções nas outras DLLs. RAS verifica as DLLs para essas funções na ordem em que elas estão listadas no registro.

Uma DLL de administração não precisa implementar a função MprAdminGetIpAddressForUser . No entanto, se a DLL implementar MprAdminGetIpAddressForUser, ela também deverá implementar MprAdminReleaseIpAddress.

Não chame nenhuma das funções de administração ras ou funções de administração de usuário ras de dentro de MprAdminGetIpAddressForUser. As chamadas para essas funções não retornarão quando feitas de dentro de uma função de texto explicativo.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h

Confira também

MprAdminReleaseIpAddress

DLL de Administração ras

Funções de administração ras

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