Función WNetAddConnectionA (winnetwk.h)
La función
Sintaxis
DWORD WNetAddConnectionA(
[in] LPCSTR lpRemoteName,
[in] LPCSTR lpPassword,
[in] LPCSTR lpLocalName
);
Parámetros
[in] lpRemoteName
Puntero a una constante cadena terminada en nullque especifica el recurso de red al que conectarse.
[in] lpPassword
Puntero a una constante cadena terminada en nullque especifica la contraseña que se va a usar para realizar una conexión. Este parámetro suele ser la contraseña asociada al usuario actual.
Si este parámetro es NULL, se usa la contraseña predeterminada. Si la cadena está vacía, no se usa ninguna contraseña.
Windows Me/98/95: Este parámetro debe ser NULL o una cadena vacía.
[in] lpLocalName
Puntero a una constante cadena terminada en nullque especifica el nombre de un dispositivo local que se va a redirigir, como "F:" o "LPT1". La cadena se trata de forma que no distingue mayúsculas de minúsculas. Si la cadena es NULL, se realiza una conexión al recurso de red sin redirigir el dispositivo local.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es un código de error del sistema , como uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
El autor de la llamada no tiene acceso al recurso de red. |
|
El dispositivo especificado en el parámetro lpLocalName ya está conectado. |
|
El tipo de dispositivo y el tipo de recurso no coinciden. |
|
El valor especificado en el parámetro lpLocalName no es válido. |
|
El valor especificado en el parámetro lpRemoteName no es válido o no se puede encontrar. |
|
El perfil de usuario tiene un formato incorrecto. |
|
El sistema no puede abrir el perfil de usuario para procesar conexiones persistentes. |
|
Ya hay una entrada para el dispositivo especificado en el parámetro lpLocalName en el perfil de usuario. |
|
Error específico de la red. Para obtener una descripción del error, llame a la función |
|
La contraseña especificada no es válida. |
|
No se puede realizar la operación porque no se inicia un componente de red o porque no se puede usar un nombre especificado. |
|
La red no está disponible. |
Observaciones
En Windows Server 2003 y Windows XP, las funciones de WNet crean y eliminan letras de unidad de red en el espacio de nombres de dispositivo MS-DOS asociado a una sesión de inicio de sesión porque los dispositivos MS-DOS se identifican mediante AuthenticationID (un
identificador único localmente, o LUID, asociado a una sesión de inicio de sesión). Esto puede afectar a las aplicaciones que llaman a una de las funciones de WNet para crear una letra de unidad de red en un inicio de sesión de usuario, pero consultar las letras de unidad de red existentes en un inicio de sesión de usuario diferente. Un ejemplo de esta situación podría ser cuando se crea el segundo inicio de sesión de un usuario en una sesión de inicio de sesión, por ejemplo, llamando a la función
En Windows Server 2003 y Windows XP, si un servicio que se ejecuta como LocalSystem llama a la función WNetAddConnection, la unidad asignada es visible para todas las sesiones de inicio de sesión de usuario.
Nota
El encabezado winnetwk.h define WNetAddConnection 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 |
winnetwk.h |
| biblioteca de |
Mpr.lib |
| DLL de |
Mpr.dll |