Función MprAdminGetIpAddressForUser (mprapi.h)

RAS llama a la función MprAdminGetIpAddressForUser una vez para cada usuario que requiera una dirección IP. RAS llama a la función con la dirección IP 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 MprAdminGetIpAddressForUser(
  [in]      WCHAR *lpwszUserName,
  [in]      WCHAR *lpwszPortName,
  [in, out] DWORD *lpdwIpAddress,
  [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] lpdwIpAddress

En la entrada, puntero a una variable DWORD que contiene cero o la dirección IP RAS asignada para el usuario.

En la salida, si RAS especificó cero, el archivo DLL asigna una dirección IP para el usuario. En este caso, si el archivo DLL no asigna una dirección IP, el usuario no puede conectarse. Si RAS especificó una dirección IP, 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 MprAdminReleaseIpAddress 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

RAS admite varios archivos DLL de administración. Sin embargo, RAS llama a MprAdminGetIpAddressForUser solo en el primer archivo DLL que implementa y exporta. RAS omite las implementaciones de estas funciones en los demás archivos DLL. RAS comprueba los archivos DLL de estas funciones en el orden en que se enumeran en el Registro.

Una DLL de administración no necesita implementar la función MprAdminGetIpAddressForUser . Sin embargo, si el archivo DLL implementa MprAdminGetIpAddressForUser, también debe implementar MprAdminReleaseIpAddress.

No llame a ninguna de las funciones de administración de RAS ni a las funciones de administración de usuarios de RAS desde mprAdminGetIpAddressForUser. Las llamadas a estas funciones no se devolverán cuando se realicen desde dentro de una función de llamada.

Requisitos

Consulte también

MprAdminReleaseIpAddress

DLL de administración de RAS

Funciones de administración de RAS

Referencia de administración de servicios de acceso remoto