Fonction MprAdminGetIpAddressForUser (mprapi.h)

Article
08/24/2023

RAS appelle la fonction MprAdminGetIpAddressForUser une fois pour chaque utilisateur qui a besoin d’une adresse IP. RAS appelle la fonction avec l’adresse IP que RAS sélectionne pour l’utilisateur. La DLL tierce qui implémente cette fonction peut remplacer cette adresse par l’une de ses propres choix.

Syntaxe

DWORD MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [out]     BOOL  *bNotifyRelease
);

Paramètres

[in] lpwszUserName

Pointeur vers une chaîne Unicode qui spécifie le nom de l’utilisateur qui nécessite une adresse IP.

[in] lpwszPortName

Pointeur vers une chaîne Unicode qui spécifie le nom du port sur lequel l’utilisateur tente de se connecter.

[in, out] lpdwIpAddress

En entrée, pointez vers une variable DWORD qui contient zéro ou l’adresse IP RAS allouée à l’utilisateur.

En sortie, si RAS a spécifié zéro, la DLL alloue une adresse IP pour l’utilisateur. Dans ce cas, si la DLL n’alloue pas d’adresse IP, l’utilisateur ne peut pas se connecter. Si RAS a spécifié une adresse IP, la DLL accepte l’adresse ou en remplace une autre.

[out] bNotifyRelease

Pointeur vers une variable BOOL . Si la DLL définit cette variable sur TRUE, RAS appelle MprAdminReleaseIpAddress lorsque l’utilisateur se déconnecte. Dans le cas contraire, RAS n’avertit pas la DLL lorsque cette adresse IP est publiée.

Valeur retournée

Si la fonction réussit, la valeur de retour doit être NO_ERROR.

Si la fonction retourne autre chose que NO_ERROR, RAS met fin à la connexion.

Notes

RAS prend en charge plusieurs DLL d’administration. Toutefois, RAS appelle MprAdminGetIpAddressForUser uniquement dans la première DLL qui l’implémente et l’exporte. RAS ignore les implémentations de ces fonctions dans les autres DLL. RAS vérifie les DLL pour ces fonctions dans l’ordre dans lequel elles sont répertoriées dans le Registre.

Une DLL d’administration n’a pas besoin d’implémenter la fonction MprAdminGetIpAddressForUser . Toutefois, si la DLL implémente MprAdminGetIpAddressForUser, elle doit également implémenter MprAdminReleaseIpAddress.

N’appelez pas les fonctions d’administration RAS ou les fonctions d’administration des utilisateurs RAS à partir de MprAdminGetIpAddressForUser. Les appels à ces fonctions ne sont pas retournés lorsqu’ils sont effectués à partir d’une fonction de légende.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h

Voir aussi

MprAdminReleaseIpAddress

DLL d’administration RAS

Fonctions d’administration RAS

Informations de référence sur l’administration du service d’accès à distance

Partager via