Función MprAdminGetIpv6AddressForUser (mprapi.h)

RAS llama a la función MprAdminGetIpv6AddressForUser una vez para cada usuario que requiera una dirección IPv6. RAS llama a la función con la dirección IPv6 que RAS selecciona para el usuario. El archivo DLL de terceros que implementa esta función puede cambiar esta dirección a una de sus propias selecciones.

Sintaxis

DWORD MprAdminGetIpv6AddressForUser(
  [in]      WCHAR    *lpwszUserName,
  [in]      WCHAR    *lpwszPortName,
  [in, out] IN6_ADDR *lpdwIpv6Address,
  [out]     BOOL     *bNotifyRelease
);

Parámetros

[in] lpwszUserName

Puntero a una cadena Unicode que especifica el nombre del usuario que requiere una dirección IP.

[in] lpwszPortName

Puntero a una cadena Unicode que especifica el nombre del puerto en el que el usuario intenta conectarse.

[in, out] lpdwIpv6Address

Puntero a una estructura de in6_addr que contiene cero o la dirección RAS IPv6 asignada al usuario.

Actualmente, solo se admiten identificadores de 64 bits.

En la salida, si RAS especificó cero, el archivo DLL asigna una dirección IPv6 para el usuario. En este caso, si el archivo DLL no asigna una dirección IPv6, el usuario no puede conectarse. Si RAS especificó una dirección IPv6, el archivo DLL acepta la dirección o sustituye una diferente.

[out] bNotifyRelease

Puntero a una variable BOOL . Si el archivo DLL establece esta variable en TRUE, RAS llama a MprAdminReleaseIpv6AddressForUser cuando el usuario se desconecta. De lo contrario, RAS no notifica al archivo DLL cuando se libera esta dirección IP.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto debe ser NO_ERROR.

Si la función devuelve algo distinto de NO_ERROR, RAS finalizará la conexión.

Comentarios

Un archivo DLL de administración no necesita implementar la función MprAdminGetIpv6AddressForUser . Sin embargo, si el archivo DLL implementa MprAdminGetIpv6AddressForUser, también debe implementar MprAdminReleaseIpv6AddressForUser.

Requisitos

Consulte también

MprAdminReleaseIpv6AddressForUser

DLL de administración de RAS

Funciones de administración de RAS

Referencia de administración de servicios de acceso remoto