Compartir a través de


Función NetWkstaTransportAdd (lmwksta.h)

[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 Conexiones de red y acceso telefónico .

No compatible.

La función NetWkstaTransportAdd enlaza (o conecta) el redirector al transporte. El redirector es el software del equipo cliente que genera solicitudes de archivo al equipo servidor.

Sintaxis

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

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

Especifica el nivel de información de los datos. Este parámetro puede ser el siguiente valor.

Valor Significado
0
Especifica la información del protocolo de transporte de estación de trabajo. El parámetro buf apunta a una estructura WKSTA_TRANSPORT_INFO_0 .

[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 red.

[out] parm_err

Puntero a un valor que recibe el índice del primer parámetro que provoca el error ERROR_INVALID_PARAMETER. Si este parámetro es NULL, el índice no se devuelve en caso de error.

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_LEVEL
El parámetro level, que indica qué nivel de información de estructura de datos está disponible, no es válido.
ERROR_INVALID_PARAMETER
Uno de los parámetros de función no es válido.

Comentarios

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

Si la función NetWkstaTransportAdd devuelve ERROR_INVALID_PARAMETER, puede usar el parámetro parm_err para indicar el miembro de la estructura WKSTA_TRANSPORT_INFO_0 que no es válida. En la tabla siguiente se enumeran los valores que se pueden devolver en el parámetro parm_err y el miembro de estructura correspondiente que se encuentra en error.

Valor Miembro
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

Requisitos

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