Función NetUseDel (lmuse.h)

  • Artículo

La función NetUseDel finaliza una conexión a un recurso compartido.

También puede usar la función WNetCancelConnection2 para finalizar una conexión de red.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Parámetros

[in] UncServerName

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] UseName

Puntero a una cadena que especifica la ruta de acceso de la conexión que se va a eliminar.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

[in] ForceLevelFlags

Nivel de fuerza que se va a usar para eliminar la conexión.

Este parámetro puede ser uno de los siguientes valores definidos en el archivo de encabezado lmusbt.h .

Valor Significado
USE_NOFORCE
 Se produce un error en la desconexión si existen archivos abiertos en la conexión.
USE_FORCE
 No produzca un error en la desconexión si existen archivos abiertos en la conexión.
USE_LOTS_OF_FORCE
 Cierre los archivos abiertos y elimine la conexión.

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

La función NetUseDel solo se aplica al cliente del bloque de mensajes del servidor (estación de trabajo de LAN Manager). La función NetUseDel no admite recursos compartidos del Sistema de archivos distribuidos (DFS) ni otros sistemas de archivos de red. Para finalizar una conexión a un recurso compartido mediante un proveedor de red diferente (WebDAV o un recurso compartido DFS, por ejemplo), use la función WNetCancelConnection2 .

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

Requisitos

   
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

Consulte también

NetUseAdd

Funciones de administración de red

Introducción a la administración de redes

Uso de funciones

WNetCancelConnection2