Función RasGetAutodialAddressA (ras.h)
La función RasGetAutodialAddress recupera información sobre todas las entradas AutoDial asociadas a una dirección de red en la base de datos de asignación AutoDial.
Sintaxis
DWORD RasGetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] LPDWORD unnamedParam2,
[in, out] LPRASAUTODIALENTRYA unnamedParam3,
[in, out] LPDWORD unnamedParam4,
[out] LPDWORD unnamedParam5
);
Parámetros
[in] unnamedParam1
Puntero a una cadena terminada en null que especifica la dirección para la que se solicita información. Puede ser una dirección IP, un nombre de host de Internet ("www.microsoft.com") o un nombre NetBIOS ("products1").
Si este parámetro es NULL, la función recupera la conexión a Internet predeterminada. La función devuelve la conexión a Internet predeterminada por usuario si se configura una. De lo contrario, la función devuelve la conexión a Internet predeterminada global. Si no se configura ninguna conexión a Internet predeterminada, la función devuelve cero para los parámetros lpdwcbAutoDialEntries y lpdwcAutoDialEntries .
[in] unnamedParam2
Reservados; debe ser NULL.
[in, out] unnamedParam3
Puntero a un búfer que, en la salida, recibe una matriz de estructuras RASAUTODIALENTRY , una para cada entrada AutoDial asociada a la dirección especificada por el parámetro lpszAddress .
En la entrada, establezca el miembro dwSize de la primera estructura RASAUTODIALENTRY del búfer en sizeof(RASAUTODIALENTRY) para identificar la versión de la estructura.
Si lpAutoDialEntries es NULL, RasGetAutodialAddress establece los parámetros lpdwcbAutoDialEntries y lpdwcAutoDialEntries para indicar el tamaño de búfer necesario, en bytes y el número de entradas AutoDial.
[in, out] unnamedParam4
Puntero a una variable que, en la entrada, especifica el tamaño, en bytes, del búfer lpAutoDialEntries .
En la salida, esta variable recibe el número de bytes devueltos o el número de bytes necesarios si el búfer es demasiado pequeño.
[out] unnamedParam5
Puntero a una variable que recibe el número de elementos de estructura devueltos en el búfer lpAutoDialEntries .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.
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 |
|---|---|
|
El miembro dwSize de la estructura RASAUTODIALENTRY es un valor no válido. |
|
El parámetro lpszAddress, lpdwcbAutoDialEntries o lpdwcAutoDialEntries era NULL. |
Comentarios
El Servicio de acceso remoto (RAS) admite conexiones a Internet predeterminadas. RAS admite una conexión a Internet predeterminada que es global para el equipo local y, además, admite una conexión a Internet predeterminada para cada usuario.
El nombre de la conexión a Internet predeterminada global se almacena en el registro debajo de la siguiente clave del Registro:
HKEY_LOCAL_MACHINE Software Microsoft Ras Autodial Default
El valor que almacena el nombre de la conexión es:
DefaultInternet
Este valor es de tipo REG_SZ.
La conexión a Internet predeterminada global debe configurarse como Para todos los usuarios en la interfaz de usuario de Connections Carpeta.
El nombre de la conexión a Internet predeterminada por usuario se almacena en el registro debajo de la siguiente clave del Registro:
HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\Predeterminado
El valor que almacena el nombre de la conexión es:
DefaultInternet
Este valor es de tipo REG_SZ.
Nota
El encabezado ras.h define RasGetAutodialAddress como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
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 | ras.h |
| Library | Rasapi32.lib |
| Archivo DLL | Rasapi32.dll |
Consulte también
Información general sobre el servicio de acceso remoto (RAS)