Función NetShareDel (lmshare.h)

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.

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

Consulte también

NetShareAdd

NetShareDelEx

Funciones de administración de redes

Introducción a la administración de redes

Funciones de recurso compartido de red