Función NetShareDel (lmshare.h)

Artículo
08/24/2023

Elimina un nombre de recurso compartido de la lista de recursos compartidos de un servidor, desconectando todas las conexiones al recurso compartido.

La función extendida NetShareDelEx 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 NetShareDel(
  [in] LMSTR servername,
  [in] LMSTR netname,
       DWORD reserved
);

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

Puntero a una cadena que especifica el nombre del recurso compartido que se va a eliminar.

Esta cadena es Unicode si se define _WIN32_WINNT o FORCE_UNICODE .

reserved

Reservado, debe ser 0.

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	El parámetro especificado no es válido.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible.
NERR_NetNameNotFound	El nombre del recurso compartido no existe.

Comentarios

Esta función solo se aplica a los recursos compartidos del bloque de mensajes del servidor (SMB). Para otros tipos de recursos compartidos, como sistemas de archivos distribuidos (DFS) o recursos compartidos de WebDAV, use funciones de Redes de Windows (WNet), que admiten todos los tipos de recursos compartidos.

Solo los miembros del grupo local Administradores, Operadores de servidor o Usuarios avanzados, o aquellos con pertenencia al grupo Operador de servidor, pueden eliminar correctamente los recursos compartidos de archivos con una llamada a la función NetShareDel . El operador print puede eliminar recursos compartidos de impresora.

Si está programando para Active Directory, puede llamar a determinados métodos de interfaz de servicio de Active Directory (ADSI) para lograr la misma funcionalidad que puede lograr llamando a las funciones de recurso compartido de administración de red. Para obtener más información, vea IADsFileShare.

Ejemplos

En el ejemplo de código siguiente se muestra cómo eliminar un recurso compartido mediante una llamada a la función NetShareDel .

#ifndef UNICODE
#define UNICODE
#endif
#include <windows.h>
#include <stdio.h>
#include <lm.h>
#pragma comment(lib, "Netapi32.lib")

void wmain( int argc, TCHAR *argv[ ])
{
   NET_API_STATUS res;

   if(argc<3)
      printf("Usage: NetShareDel server share\n");
   else
   {
      //
      // Call the NetShareDel function to delete the share.
      //
      res=NetShareDel(argv[1], argv[2], 0);
      //
      // Display the result of the call.
      //
      if(res==0)
         printf("Share Removed.\n");
      else
         printf("Error: %u\n", res);
   }
   return;
}

Requisitos


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