Compartir a través de

Uso compartido de funciones

  • Artículo

Las funciones de recurso compartido de administración 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.

 

Esta función de recurso compartido solo se aplica a los recursos compartidos en un servidor de bloque de mensajes del servidor (Administrador de LAN). Estas funciones de recurso compartido no admiten recursos compartidos del sistema de archivos distribuidos (DFS). Por ejemplo, la función NetShareGetInfo solo puede recuperar información de un recurso compartido especificado en un servidor SMB. Para recuperar información de un recurso compartido mediante un proveedor de red diferente (WebDAV o un recurso compartido DFS, por ejemplo), use la función WNetGetConnection .

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 recurso compartido están disponibles en los siguientes niveles de información, aunque algunos niveles de recurso compartido solo son aplicables a algunas de las funciones de recurso compartido:

Revise la documentación de una función de recurso compartido específica para obtener más información.

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.