Función de devolución de llamada RasCustomDialFn (ras.h)

Artículo
08/25/2023

[Esta función no está disponible a partir de Windows Server 2008.

]

La función RasCustomDial es una función definida por la aplicación que exporta un archivo DLL de marcado personalizado de terceros. Esta función permite a los proveedores de terceros implementar rutinas personalizadas de marcado de acceso remoto.

Sintaxis

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Parámetros

hInstDll

Controle la instancia del archivo DLL de marcado personalizado que se cargó.

lpRasDialExtensions

Puntero a una estructura RASDIALEXTENSIONS que especifica un conjunto de características extendidas rasDial que se van a habilitar. Establezca este parámetro en NULL si no es necesario habilitar las extensiones.

lpszPhonebook

Puntero a una cadena terminada en null que especifica la ruta de acceso completa y el nombre de archivo de un archivo de libreta telefónica (PBK). Si este parámetro es NULL, la función usa el archivo de libreta telefónica predeterminado actual. El archivo de libreta telefónica predeterminado es el seleccionado por el usuario en la hoja de propiedades Preferencias de usuario del cuadro de diálogo Redes de acceso telefónico .

lpRasDialParams

Puntero a una estructura RASDIALPARAMS que especifica los parámetros de llamada para la conexión RAS.

El llamador debe establecer el miembro dwSize de la estructura RASDIALPARAMS en sizeof(RASDIALPARAMS) para identificar la versión de la estructura que se pasa.

dwNotifierType

Este parámetro es el mismo que el parámetro dwNotifierType para la función RasDial . Consulte la página de referencia de RasDial para obtener más información.

lpvNotifier

Este parámetro es el mismo que el parámetro lpvNotifier para la función RasDial . Consulte la página de referencia de RasDial para obtener más información.

lphRasConn

Puntero a una variable de tipo HRASCONN. Establezca la variable HRASCONN en NULL antes de llamar a RasDial. Si RasDial se realiza correctamente, almacena un identificador de la conexión RAS en *lphRasConn.

dwFlags

Este parámetro está reservado para su uso futuro.

Valor devuelto

Si la función se ejecuta correctamente, se ERROR_SUCCESS el valor devuelto y se devuelve un identificador de la conexión RAS en la variable a la que apunta el parámetro lphRasConn .

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error o un valor de Códigos de error de enrutamiento y acceso remoto o Winerror.h.

Valor	Significado
ERROR_NOT_ENOUGH_MEMORY	La función no pudo asignar suficiente memoria para completar la operación.

Comentarios

RAS llama a este punto de entrada desde RasDial, si el miembro szCustomDialDll de la estructura RASENTRY para la entrada que se está marcando especifica un archivo DLL de marcado personalizado.

Si este punto de entrada llama a RasDial, el parámetro lpRasDialExtensions no debe ser NULL y el miembro dwFlags de la estructura RASDIALEXTENSIONS debe tener establecida la marca RDEOPT_CustomDial.

Si el archivo DLL de marcado personalizado no admite este punto de entrada, RAS devuelve ERROR_CANNOT_DO_CUSTOMDIAL al autor de la llamada de RasDial.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ras.h