Fonction MprAdminGetIpv6AddressForUser (mprapi.h)

Article
08/24/2023

RAS appelle la fonction MprAdminGetIpv6AddressForUser une fois pour chaque utilisateur qui nécessite une adresse IPv6. RAS appelle la fonction avec l’adresse IPv6 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 MprAdminGetIpv6AddressForUser(
  [in]      WCHAR    *lpwszUserName,
  [in]      WCHAR    *lpwszPortName,
  [in, out] IN6_ADDR *lpdwIpv6Address,
  [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] lpdwIpv6Address

Pointeur vers une structure de in6_addr qui contient zéro ou l’adresse IPv6 RAS allouée à l’utilisateur.

Actuellement, seuls les identificateurs 64 bits sont pris en charge.

En sortie, si RAS a spécifié zéro, la DLL alloue une adresse IPv6 pour l’utilisateur. Dans ce cas, si la DLL n’alloue pas d’adresse IPv6, l’utilisateur ne peut pas se connecter. Si RAS a spécifié une adresse IPv6, 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 MprAdminReleaseIpv6AddressForUser 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

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

Spécifications


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

Voir aussi

MprAdminReleaseIpv6AddressForUser

DLL d’administration RAS

Fonctions d’administration RAS

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

Partager via