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

Artículo
03/05/2024

La función RasCustomEntryDlg 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 diálogos personalizados para administrar entradas de libreta de teléfonos.

Sintaxis

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

Parámetros

hInstDll

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

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 para editar, copiar o crear.

Si está editando o copiando una entrada, este parámetro es el nombre de una entrada de libreta de teléfono existente. Si va a copiar una entrada, establezca la marca RASEDFLAG_CloneEntry en el miembro dwFlags de la estructura RASENTRYDLG .

Si va a crear una entrada, este parámetro es un nuevo nombre de entrada predeterminado que el usuario puede cambiar. Si este parámetro es NULL, la función proporciona un nombre predeterminado. Si va a crear una entrada, establezca la marca RASEDFLAG_NewEntry en el miembro dwFlags de la estructura RASENTRYDLG .

lpInfo

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

dwFlags

Reservado para uso futuro.

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 RasEntryDlg, si el miembro szCustomDialDll de la estructura RASENTRY para la entrada que se marca especifica un archivo DLL de marcado personalizado.

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

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