Función NetShareDelEx (lmshare.h)

Artículo
03/13/2024

Elimina un nombre de recurso compartido de la lista de recursos compartidos de un servidor, que desconecta todas las conexiones a ese recurso compartido. Esta función, que es una versión extendida de la función NetShareDel , permite al autor de la llamada especificar una estructura de SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2, SHARE_INFO_502 o SHARE_INFO_503 .

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

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 es Unicode si se define _WIN32_WINNT o FORCE_UNICODE .

[in] level

Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
0, 1, 2 o 502	Especifica información sobre el recurso compartido, incluido el nombre del recurso, el tipo y los permisos, y el número de conexiones. El parámetro buf apunta a una estructura SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 o SHARE_INFO_502 .
503	Especifica información sobre el recurso compartido, incluido el nombre del recurso, el tipo y los permisos, el número de conexiones y otra información pertinente. El parámetro buf apunta a una estructura SHARE_INFO_503 .

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

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_INTERNAL_ERROR	Se ha producido un error interno.
ERROR_INVALID_LEVEL	El valor especificado para el parámetro level no es válido.
ERROR_NOT_SUPPORTED	No se admite la solicitud.

Comentarios

Si se especifica 503 para el parámetro level , el parámetro buf apunta a una estructura de SHARE_INFO_503 y los shi503_netname y shi503_servername miembros de esa estructura se usan para buscar el recurso compartido en el servidor; se omiten los demás miembros. El servidor remoto especificado en el miembro shi503_servername debe haberse enlazado a un protocolo de transporte mediante la función NetServerTransportAddEx . En la llamada a NetServerTransportAddEx, se debe haber especificado 2 o 3 para el parámetro level y la marca SVTI2_SCOPED_NAME debe haberse especificado en la estructura SERVER_TRANSPORT_INFO_2 para el protocolo de transporte.

Si se especifica 0, 1, 2 o 502 para el parámetro level , el parámetro buf apunta a un SHARE_INFO_0, SHARE_INFO_1, SHARE_INFO_2 o estructura de SHARE_INFO_502 , y se utiliza el shi0_netname, shi1_netname, shi2_netname o shi502_netname miembro de esa estructura; se omiten los demás miembros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmshare.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll