Función NetWkstaTransportEnum (lmwksta.h)

Artículo
03/14/2023

La función NetWkstaTransportEnum proporciona información sobre los protocolos de transporte administrados por el redirector, que es el software del equipo cliente que genera solicitudes de archivo al equipo servidor.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportEnum(
  [in]      LPTSTR  servername,
  [in]      DWORD   level,
  [out]     LPBYTE  *bufptr,
  [in]      DWORD   prefmaxlen,
  [out]     LPDWORD entriesread,
  [out]     LPDWORD totalentries,
  [in, out] LPDWORD resume_handle
);

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.

[in] level

Nivel de información solicitada para los datos. Este parámetro puede ser el siguiente valor.

Valor	Significado
0	Devuelve la información del protocolo de transporte de estación de trabajo. El parámetro bufptr apunta a una matriz de estructuras WKSTA_TRANSPORT_INFO_0 .

[out] bufptr

Puntero al búfer que recibe los datos. El formato de estos datos depende del valor del parámetro level . El sistema asigna este búfer y se debe liberar mediante la función NetApiBufferFree . Tenga en cuenta que debe liberar el búfer incluso si se produce un error en la función con ERROR_MORE_DATA o NERR_BufTooSmall.

[in] prefmaxlen

Longitud máxima preferida de los datos devueltos, en bytes. Si especifica MAX_PREFERRED_LENGTH, la función asigna la cantidad de memoria necesaria para los datos. Si especifica otro valor en este parámetro, puede restringir el número de bytes que devuelve la función. Si el tamaño del búfer no es suficiente para contener todas las entradas, la función devuelve ERROR_MORE_DATA o NERR_BufTooSmall. Para obtener más información, consulte Network Management Function Buffers (Búferes de funciones de administración de red) y Network Management Function Buffer Lengths (Longitudes de búfer de funciones de administración de red).

[out] entriesread

Puntero a un valor que recibe el recuento de elementos enumerados realmente.

[out] totalentries

Puntero a un valor que recibe el número total de entradas que se podrían haber enumerado a partir de la posición de reanudación actual. Tenga en cuenta que las aplicaciones deben considerar este valor solo como sugerencia.

[in, out] resume_handle

Puntero a un valor que contiene un identificador de reanudación que se usa para continuar una búsqueda de transporte de estación de trabajo existente. El identificador debe ser cero en la primera llamada y dejar sin cambios para las llamadas posteriores. Si el parámetro resumehandle es un puntero NULL , no se almacena ningún identificador de reanudació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_MORE_DATA	Hay más entradas disponibles. Especifique un búfer suficientemente grande para recibir todas las entradas.
ERROR_INVALID_LEVEL	El parámetro level, que indica qué nivel de información de estructura de datos está disponible, no es válido. Este error se devuelve si el parámetro level se especifica como un valor distinto de cero.
ERROR_INVALID_PARAMETER	Uno o varios parámetros no eran válidos. Este error se devuelve si los parámetros bufptrotriesread son punteros NULL .
ERROR_NOT_ENOUGH_MEMORY	Memoria insuficiente estaba disponible para procesar la solicitud.
ERROR_NOT_SUPPORTED	No se admite la solicitud. Este error se devuelve si se especificó un servidor remoto en el parámetro servername y esta solicitud no se admite en el servidor remoto.
NERR_BufTooSmall	Hay más entradas disponibles. Especifique un búfer suficientemente grande para recibir todas las entradas. Este código de error se define en el archivo de encabezado Lmerr.h .

Comentarios

No se requiere pertenencia a grupos especiales para ejecutar correctamente la función NetWkstaTransportEnum .

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