Função de retorno de chamada RasAdminReleaseIpAddress

[A função RasAdminReleaseIpAddress está disponível para uso no Windows NT 4.0 e não está disponível nas versões subsequentes. Em vez disso, use MprAdminReleaseIpAddress.]

A função RasAdminReleaseIpAddress é uma função definida pelo aplicativo que é exportada por uma DLL de administração de servidor RAS de terceiros. RAS chama essa função para notificar a DLL de que o cliente remoto foi desconectado e que o endereço IP deve ser liberado.

Sintaxe

void CALLBACK RasAdminReleaseIpAddress(
  _In_ WCHAR  *lpszUserName,
  _In_ WCHAR  *lpszPortName,
  _In_ IPADDR *pipAddress
);

Parâmetros

lpszUserName [in]

Especifica o ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome de um usuário remoto para o qual um endereço IP foi obtido anteriormente usando a função RasAdminGetIpAddressForUser .

lpszPortName [in]

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da porta na qual o usuário especificado por lpszUserName está conectado.

pipAddress [in]

Ponteiro para uma variável IPADDR que especifica o endereço IP retornado para esse usuário em uma chamada anterior para RasAdminGetIpAddressForUser.

Valor retornado

Não há informações de erro estendidas para essa função; não chame GetLastError.

Comentários

O servidor RAS chamará a função RasAdminReleaseIpAddress somente se o aplicativo retornasse TRUE no parâmetro bNotifyRelease durante a chamada anterior para RasAdminGetIpAddressForUser para o usuário especificado pelo parâmetro lpszUserName .

O programa de instalação de uma DLL de administração ras de terceiros deve registrar a DLL com RAS fornecendo informações sob a seguinte chave no Registro:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

Para registrar a DLL, defina os seguintes valores sob essa chave.

Nome do valor	Dados do valor
DisplayName	Uma cadeia de caracteres REG_SZ que contém o nome de exibição amigável da DLL.
DLLPath	Uma cadeia de caracteres REG_SZ que contém o caminho completo da DLL.

 

Por exemplo, a entrada do Registro para uma DLL de administração ras de uma empresa fictícia chamada ProElectron, Inc. pode ser:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DisplayName: REG_SZ: ProElectron RAS Administração DLLPath: REG_SZ : C:\nt\system32\ntwkadm.dll

O programa de instalação de uma DLL de administração ras também deve fornecer funcionalidade de remoção/desinstalação. Se um usuário remover a DLL, o programa de instalação deverá excluir as entradas do Registro da DLL.