Funciones de recurso compartido de red

Las funciones de recurso compartido de red controlan los recursos compartidos. Un recurso compartido es un recurso local en un servidor (por ejemplo, un directorio de disco, un dispositivo de impresión o una canalización con nombre) al que pueden acceder los usuarios y las aplicaciones de la red.

Las funciones de recurso compartido se enumeran a continuación.

Función Descripción
NetShareAdd Comparte un recurso en un servidor.
NetShareCheck Consulta si un servidor comparte un dispositivo.
NetShareDel Elimina un nombre de recurso compartido de la lista de recursos compartidos de un servidor.
NetShareEnum Recupera información de recurso compartido sobre cada recurso compartido en un servidor.
NetShareGetInfo Recupera información sobre un recurso compartido especificado en un servidor.
NetShareSetInfo Establece los parámetros de un recurso compartido.

 

La función NetShareAdd permite a un usuario o aplicación compartir un recurso de un tipo específico mediante el nombre de recurso compartido especificado. La función NetShareAdd requiere el nombre del recurso compartido y el nombre del dispositivo local para compartir el recurso. Un usuario o aplicación debe tener una cuenta en el servidor para acceder al recurso.

También puede especificar un descriptor de seguridad que se asociará a un recurso compartido. Los descriptores de seguridad especifican qué usuarios pueden acceder a los archivos a través del recurso compartido y con qué tipo de acceso. Especifique un SECURITY_DESCRIPTOR con el nivel de información de SHARE_INFO_502 al llamar a NetShareAdd o NetShareSetInfo. NetShareSetInfo admite el nivel de información de SHARE_INFO_1501 . Para obtener más información sobre los descriptores de seguridad, consulte Access Control.

Las funciones de administración de red usan los siguientes nombres de recurso compartido especiales para la comunicación entre procesos (IPC) y la administración remota del servidor:

  • IPC$, reservado para la comunicación entre procesos
  • ADMIN$, reservado para la administración remota
  • A$, B$, C$ (y otros nombres de disco local seguidos de un signo de dólar), asignados a dispositivos de disco local

Para enumerar todas las conexiones realizadas a un recurso compartido en un servidor o para enumerar todas las conexiones establecidas desde un equipo determinado, llame a la función NetConnectionEnum . Puede llamar a NetConnectionEnum en los niveles de información de CONNECTION_INFO_0 y CONNECTION_INFO_1 .

Las funciones de uso compartido están disponibles en los siguientes niveles de información:

SHARE_INFO_0
SHARE_INFO_1
SHARE_INFO_2
SHARE_INFO_501
SHARE_INFO_502
SHARE_INFO_1005

Los niveles de información siguientes solo son válidos para NetShareSetInfo:

SHARE_INFO_1004
SHARE_INFO_1006
SHARE_INFO_1501

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.