Función RasSetAutodialAddressA (ras.h)
La función
Sintaxis
DWORD RasSetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] DWORD unnamedParam2,
[in] LPRASAUTODIALENTRYA unnamedParam3,
[in] DWORD unnamedParam4,
[in] DWORD unnamedParam5
);
Parámetros
[in] unnamedParam1
Puntero a un cadena terminada en nullque especifica la dirección que se va a agregar, eliminar o modificar. Esta direcció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 establece la conexión a Internet predeterminada (vea Comentarios). Si este parámetro apunta a una cadena de longitud cero, la función elimina la conexión a Internet predeterminada.
[in] unnamedParam2
Reservado; debe ser cero.
[in] unnamedParam3
Puntero a una matriz de una o varias estructuras de
[in] unnamedParam4
Especifica el tamaño, en bytes, del búfer de lpAutoDialEntries.
[in] unnamedParam5
Especifica el número de estructuras de de
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es 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 del RASAUTODIALENTRY estructura es un valor no válido. |
|
El parámetro lpszAddress es NULL. |
|
El nombre de conexión especificado en lpAutoDialEntries no existe. |
Observaciones
Una dirección de la base de datos de asignación autoDial puede tener cualquier número de entradas de RASAUTODIALENTRY asociadas. Cada entrada especifica información autodial para una ubicación de marcado TAPI determinada.
Si la dirección especificada por el parámetro lpszAddress es una dirección existente en la base de datos y el parámetro lpAutoDialEntries no es NULL, la función RasSetAutodialAddress modifica el conjunto de entradas AutoDial asociadas a la dirección. Si una entrada de la lpAutoDialEntries matriz especifica una ubicación de marcado para la que la dirección ya tiene una entrada, la función reemplaza la entrada existente por la nueva entrada. De lo contrario, la función simplemente agrega el lpAutoDialEntries entradas al conjunto de entradas para la dirección.
Si la dirección de
Si la dirección lpszAddress no existe en la base de datos, RasSetAutodialAddress agrega la dirección a la base de datos. El parámetro lpAutoDialEntries especifica las entradas AutoDial que se van a asociar a la nueva dirección.
RAS admite una conexión a Internet predeterminada que es global para el equipo local y admite una conexión a Internet predeterminada para cada usuario.
Cuando el parámetro lpszAddress es null, y el parámetro lpAutoDialEntries especifica un nombre de conexión con una entrada, RasSetAutodialAddress establece la conexión como conexión a Internet predeterminada. El nombre de conexión especificado en lpAutoDialEntries ya debería existir. Si no es así, se devolverá ERROR_CANNOT_FIND_PHONEBOOK_ENTRY.
Cuando el parámetro lpszAddress es una cadena de longitud cero y el parámetro lpAutoDialEntries especifica un nombre de conexión vacío con una entrada, RasSetAutodialAddress elimina la conexión a Internet predeterminada.
En las máquinas cliente que no son de dominio, si un usuario quiere establecer una conexión como la conexión a Internet predeterminada y especifica una conexión "for-all-users" en el szEntry miembro de la estructura de RASAUTODIALENTRY, la conexión a Internet predeterminada se establece globalmente en el equipo local. En todos los demás casos, la conexión a Internet predeterminada se establece para cada usuario de la máquina individualmente.
Es posible tener dos conexiones que tengan el mismo nombre si una está configurada como una conexión "for-all-users" y la otra está configurada como una conexión "solo para mí". Si el parámetro lpAutoDialEntries especifica un nombre de conexión que corresponde a una conexión global y por usuario, se establece la conexión por usuario.
Nota
El encabezado ras.h define RasSetAutodialAddress 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
ras.h |
| biblioteca de |
Rasapi32.lib |
| DLL de |
Rasapi32.dll |