Función de devolución de llamada RasCustomDialDlgFn (rasdlg.h)

Artículo
03/01/2024

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

]

La función RasCustomDialDlg 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 cuadros de diálogo de conexión RAS personalizados.

Sintaxis

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Parámetros

hInstDll

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

dwFlags

Conjunto de marcas de bits que especifican las opciones RasCustomDialDlg .

Valor	Significado
RCD_Logon	Si esta marca está establecida en una, la conexión se marcó desde un contexto de inicio de sesión de Windows. RasDial usa esta información para obtener las preferencias de usuario adecuadas para la entrada de conexión. Si se llama a RasDial desde este punto de entrada, el miembro dwfOptions del parámetro lpRasDialExtension debe tener la marca RDEOPT_NoUser establecida para indicar que la conexión se marcó desde un contexto de inicio de sesión de Windows.

Valor

Significado

RCD_Logon

Si esta marca está establecida en una, la conexión se marcó desde un contexto de inicio de sesión de Windows. RasDial usa esta información para obtener las preferencias de usuario adecuadas para la entrada de conexión. Si se llama a RasDial desde este punto de entrada, el miembro dwfOptions del parámetro lpRasDialExtension debe tener la marca RDEOPT_NoUser establecida para indicar que la conexión se marcó desde un contexto de inicio de sesión de Windows.

Windows Server 2003 y Windows XP/2000: Este parámetro está reservado y no se debe usar.

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 de teléfonos (PBK). Si este parámetro es NULL, la función usa el archivo de libreta de teléfonos 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 .

lpszEntry

Puntero a una cadena terminada en null que contiene el nombre de la entrada de la libreta de teléfonos que se va a marcar.

lpszPhoneNumber

Puntero a una cadena terminada en null que contiene un número de teléfono que invalida los números almacenados en la entrada de la libreta de teléfonos. Si este parámetro es NULL, RasDialDlg usa los números de la entrada de la libreta de teléfonos.

lpInfo

Puntero a una estructura RASDIALDLG que contiene parámetros de entrada y salida adicionales. En la entrada, el miembro dwSize de esta estructura debe especificar sizeof( RASDIALDLG). Si se produce un error, el miembro dwError devuelve un código de error; de lo contrario, devuelve cero.

pvInfo

Reservado para uso interno. Este parámetro siempre será NULL.

Valor devuelto

Si el usuario crea, copia o edita una entrada de libreta de teléfonos, el valor devuelto debe ser TRUE. De lo contrario, la función debe devolver FALSE.

Si se produce un error, RasCustomEntryDlg debe establecer el miembro dwError de la estructura RASENTRYDLG en un valor de Enrutamiento y códigos de error de acceso remoto o Winerror.h.

Comentarios

RAS llama a este punto de entrada desde RasDialDlg, si el miembro szCustomDialDll de la estructura RASENTRY para la entrada que se marca 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 dwfOptions de la estructura RASDIALEXTENSIONS debe tener establecida la marca RDEOPT_CustomDial .

El cuadro de diálogo de marcado personalizado debe admitir WM_COMMAND mensajes en los que LOWORD(wParam) sea igual a IDCANCEL.

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 RasDialDlg.

Requisitos

Requisito	Value
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	rasdlg.h