Función NetUseDel (lmuse.h)
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 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
Funciones de administración de red