MprAdminGetIpv6AddressForUser, fonction (mprapi.h)

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 changer cette adresse en l’un 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 in6_addr qui contient zéro ou la ras d’adresse IPv6 allouée pour 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 n’est pas en mesure de se connecter. Si RAS a spécifié une adresse IPv6, la DLL accepte l’adresse ou 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. Sinon, 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 quelque chose d’autre que NO_ERROR, RAS met fin à la connexion.

Remarques

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.

Configuration requise

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