Función NetWkstaTransportDel (lmwksta.h)

  • Artículo

[Esta función está obsoleta. Para cambiar manualmente la configuración predeterminada de los protocolos de transporte, use el cuadro de diálogo Propiedades de conexión de área local en la carpeta Red y Acceso telefónico Connections.

No compatible.

La función NetWkstaTransportDel desenlace el protocolo de transporte del redirector. (El redirector es el software del equipo cliente que genera solicitudes de archivo al equipo servidor).

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

Parámetros

[in] servername

Puntero a una cadena que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

Esta cadena debe comenzar por \.

[in] transportname

Puntero a una cadena que especifica el nombre del protocolo de transporte que se va a desconectar del redirector.

[in] ucond

Especifica el nivel de fuerza que se va a usar al desconectar el protocolo de transporte del redirector. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
USE_NOFORCE
 Se produce un error en la desconexión si existen archivos abiertos en la conexión.
USE_FORCE
 Se produce 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 realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_ACCESS_DENIED
 El usuario no tiene acceso a la información pedida.
ERROR_INVALID_PARAMETER
 Uno de los parámetros de función no es válido.
NERR_UseNotFound
 La conexión de red no existe.

Comentarios

Solo los miembros del grupo local Administradores pueden ejecutar correctamente la función NetWkstaTransportDel .

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado lmwksta.h (include Lm.h, Lmwksta.h)
Library Netapi32.lib
Archivo DLL Netapi32.dll