Función de devolución de llamada RasAdminReleaseIpAddress
[La función RasAdminReleaseIpAddress está disponible para su uso en Windows NT 4.0 y no está disponible en versiones posteriores. En su lugar, use MprAdminReleaseIpAddress.]
La función RasAdminReleaseIpAddress es una función definida por la aplicación que exporta un archivo DLL de administración de servidores RAS de terceros. RAS llama a esta función para notificar al archivo DLL que el cliente remoto se desconectó y que se debe liberar la dirección IP.
Sintaxis
void CALLBACK RasAdminReleaseIpAddress(
_In_ WCHAR *lpszUserName,
_In_ WCHAR *lpszPortName,
_In_ IPADDR *pipAddress
);
Parámetros
-
lpszUserName [in]
-
Especifica el puntero a una cadena Unicode terminada en null que especifica el nombre de un usuario remoto para el que se obtuvo anteriormente una dirección IP mediante la función RasAdminGetIpAddressForUser .
-
lpszPortName [in]
-
Puntero a una cadena Unicode terminada en null que especifica el nombre del puerto en el que está conectado el usuario especificado por lpszUserName .
-
pipAddress [in]
-
Puntero a una variable IPADDR que especifica la dirección IP devuelta para este usuario en una llamada anterior a RasAdminGetIpAddressForUser.
Valor devuelto
No hay información de error extendida para esta función; no llame a GetLastError.
Comentarios
El servidor RAS llama a la función RasAdminReleaseIpAddress solo si la aplicación devolvió TRUE en el parámetro bNotifyRelease durante la llamada anterior a RasAdminGetIpAddressForUser para el usuario especificado por el parámetro lpszUserName .
El programa de instalación de un archivo DLL de administración de RAS de terceros debe registrar el archivo DLL con RAS proporcionando información bajo la siguiente clave en el registro:
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
RAS
AdminDll
Para registrar el archivo DLL, establezca los valores siguientes en esta clave.
| Nombre del valor | Datos del valor |
|---|---|
| DisplayName | Cadena REG_SZ que contiene el nombre para mostrar descriptivo del archivo DLL. |
| DLLPath | Cadena REG_SZ que contiene la ruta de acceso completa del archivo DLL. |
Por ejemplo, la entrada del Registro para un archivo DLL de administración de RAS de una empresa ficticia denominada ProElectron, Inc. podría ser:
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
RAS
AdminDll
DisplayName: REG_SZ : ProElectron RAS Administración DLL DllPath: REG_SZ : C:\nt\system32\ntwkadm.dll
El programa de instalación de un archivo DLL de administración de RAS también debe proporcionar funcionalidad de eliminación o desinstalación. Si un usuario quita el archivo DLL, el programa de instalación debe eliminar las entradas del Registro del archivo DLL.