Partager via

Fonction de rappel RasAdminReleaseIpAddress

  • Article

[La fonction RasAdminReleaseIpAddress est disponible pour une utilisation dans Windows NT 4.0 et n’est pas disponible dans les versions suivantes. Utilisez plutôt MprAdminReleaseIpAddress.]

La fonction RasAdminReleaseIpAddress est une fonction définie par l’application qui est exportée par une DLL d’administration de serveur RAS tierce. RAS appelle cette fonction pour informer la DLL que le client distant a été déconnecté et que l’adresse IP doit être libérée.

Syntaxe

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

Paramètres

lpszUserName [in]

Spécifie le pointeur vers une chaîne Unicode terminée par null qui spécifie le nom d’un utilisateur distant pour lequel une adresse IP a été précédemment obtenue à l’aide de la fonction RasAdminGetIpAddressForUser .

lpszPortName [in]

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du port sur lequel l’utilisateur spécifié par lpszUserName est connecté.

pipAddress [in]

Pointeur vers une variable IPADDR qui spécifie l’adresse IP retournée pour cet utilisateur lors d’un appel précédent à RasAdminGetIpAddressForUser.

Valeur retournée

Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.

Notes

Le serveur RAS appelle la fonction RasAdminReleaseIpAddress uniquement si l’application a retourné TRUE dans le paramètre bNotifyRelease lors de l’appel précédent à RasAdminGetIpAddressForUser pour l’utilisateur spécifié par le paramètre lpszUserName .

Le programme d’installation d’une DLL d’administration RAS tierce doit inscrire la DLL auprès de RAS en fournissant des informations sous la clé suivante dans le Registre :

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

Pour inscrire la DLL, définissez les valeurs suivantes sous cette clé.

Nom de la valeur Données de valeur
DisplayName Chaîne REG_SZ qui contient le nom d’affichage convivial de la DLL.
DLLPath Chaîne REG_SZ qui contient le chemin d’accès complet de la DLL.

 

Par exemple, l’entrée de Registre d’une DLL d’administration RAS d’une société fictive nommée ProElectron, Inc. peut être :

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         RAS
            AdminDll

DisplayName : REG_SZ : ProElectron RAS Administration DLLPath : REG_SZ : C:\nt\system32\ntwkadm.dll

Le programme d’installation d’une DLL d’administration RAS doit également fournir des fonctionnalités de suppression/désinstallation. Si un utilisateur supprime la DLL, le programme d’installation doit supprimer les entrées de Registre de la DLL.