Función NetUseAdd (lmuse.h)

Artículo
03/14/2023

La función NetUseAdd establece una conexión entre el equipo local y un servidor remoto. Puede especificar una letra de unidad local o un dispositivo de impresora para conectarse. Si no especifica una letra de unidad local o un dispositivo de impresora, la función autentica al cliente con el servidor para futuras conexiones.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetUseAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   LevelFlags,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parámetros

[in] servername

Nombre UNC del equipo en el que se va a ejecutar esta función. Si este parámetro es NULL, se usa el equipo local. Si el parámetro UncServerName especificado es un equipo remoto, el equipo remoto debe admitir llamadas RPC remotas mediante el mecanismo heredado del protocolo de acceso remoto.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

[in] LevelFlags

Valor que especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
1	Especifica información sobre la conexión entre un dispositivo local y un recurso compartido. La información incluye el estado y el tipo de conexión. El parámetro Buf es un puntero a una estructura USE_INFO_1 .
2	Especifica información sobre la conexión entre un dispositivo local y un recurso compartido. La información incluye el estado y el tipo de conexión, así como un nombre de usuario y un nombre de dominio. El parámetro Buf es un puntero a una estructura USE_INFO_2 .

[in] buf

Puntero al búfer que especifica los datos. El formato de estos datos depende del valor del parámetro Level . Para obtener más información, consulte Búferes de funciones de administración de redes.

[out] parm_err

Puntero a un valor que recibe el índice del primer miembro de la estructura de información en error cuando se devuelve el error ERROR_INVALID_PARAMETER. Si este parámetro es NULL, el índice no se devuelve cuando se produce un error. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

También puede usar las funciones WNetAddConnection2 y WNetAddConnection3 para redirigir un dispositivo local a un recurso de red.

No se requiere pertenencia a grupos especiales para llamar a la función NetUseAdd . Esta función no se puede ejecutar en un servidor remoto, excepto en casos de compatibilidad de nivel inferior.

Esta función solo se aplica al cliente bloque de mensajes del servidor (estación de trabajo de ADMINISTRADOR DE LAN). La función NetUseAdd no admite recursos compartidos del sistema de archivos distribuidos (DFS). Para agregar un recurso compartido mediante un proveedor de red diferente (WebDAV o un recurso compartido DFS, por ejemplo), use la función WNetAddConnection2 o WNetAddConnection3 .

Si la función NetUseAdd devuelve ERROR_INVALID_PARAMETER, puede usar el parámetro ParmError para indicar el primer miembro de la estructura de información que no es válida. (La estructura de información comienza por USE_INFO_ y su formato se especifica mediante el parámetro Level ). En la tabla siguiente se enumeran los valores que se pueden devolver en el parámetro ParmError y el miembro de estructura correspondiente que se encuentra en error. (El prefijo ui*_ indica que el miembro puede comenzar con varios prefijos, por ejemplo, ui1_ o ui2_).

Constante	Valor	Miembro
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

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	lmuse.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll