Compartir a través de

estructura SHARE_INFO_2 (lmshare.h)

  • Artículo

Contiene información sobre el recurso compartido, incluido el nombre del recurso, el tipo y los permisos, y el número de conexiones actuales. Para obtener más información sobre cómo controlar el acceso a objetos protegibles, vea Access Control, Privilegios y Objetos protegibles.

Sintaxis

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

Members

shi2_netname

Puntero a una cadena Unicode que especifica el nombre del recurso compartido de un recurso. Las llamadas a la función NetShareSetInfo omiten este miembro.

shi2_type

Combinación de valores que especifican el tipo del recurso compartido. Las llamadas a la función NetShareSetInfo omiten este miembro.

Se puede especificar uno de los valores siguientes. Puede aislar estos valores mediante el valor de STYPE_MASK .

Valor Significado
STYPE_DISKTREE
 Unidad de disco.
STYPE_PRINTQ
 Cola de impresión.
STYPE_DEVICE
 Dispositivo de comunicación.
STYPE_IPC
 Comunicación entre procesos (IPC).
 

Además, se puede especificar uno o ambos de los valores siguientes.

Valor Significado
STYPE_SPECIAL
 Recurso compartido especial reservado para la comunicación entre procesos (IPC$) o la administración remota del servidor (ADMIN$). También puede hacer referencia a recursos compartidos administrativos como C$, D$, E$, etc. Para obtener más información, consulte Funciones de recurso compartido de red.
STYPE_TEMPORARY
 Un recurso compartido temporal.

shi2_remark

Puntero a una cadena Unicode que contiene un comentario opcional sobre el recurso compartido.

shi2_permissions

Especifica un valor DWORD que indica los permisos del recurso compartido para los servidores que se ejecutan con seguridad de nivel de recurso compartido. Un servidor que ejecuta la seguridad de nivel de usuario omite este miembro. Este miembro puede ser uno o varios de los valores siguientes. Las llamadas a la función NetShareSetInfo omiten este miembro.

Tenga en cuenta que Windows no admite la seguridad de nivel de recurso compartido.

Valor Significado
ACCESS_READ
 Permiso para leer datos de un recurso y, de forma predeterminada, para ejecutar el recurso.
ACCESS_WRITE
 Permiso para escribir datos en el recurso.
ACCESS_CREATE
 Permiso para crear una instancia del recurso (por ejemplo, un archivo); los datos se pueden escribir en el recurso a medida que se crea el recurso.
ACCESS_EXEC
 Permiso para ejecutar el recurso.
ACCESS_DELETE
 Permiso para eliminar el recurso.
ACCESS_ATRIB
 Permiso para modificar los atributos del recurso (como la fecha y hora en que se modificó por última vez un archivo).
ACCESS_PERM
 Permiso para modificar los permisos (lectura, escritura, creación, ejecución y eliminación) asignados a un recurso para un usuario o aplicación.
ACCESS_ALL
 Permiso para leer, escribir, crear, ejecutar y eliminar recursos y modificar sus atributos y permisos.

shi2_max_uses

Especifica un valor DWORD que indica el número máximo de conexiones simultáneas que el recurso compartido puede dar cabida. El número de conexiones es ilimitado si el valor especificado en este miembro es –1.

shi2_current_uses

Especifica un valor DWORD que indica el número de conexiones actuales al recurso. Las llamadas a la función NetShareSetInfo omiten este miembro.

shi2_path

Puntero a una cadena Unicode que especifica la ruta de acceso local para el recurso compartido. En el caso de los discos, shi2_path es la ruta de acceso que se comparte. Para las colas de impresión, shi2_path es el nombre de la cola de impresión que se comparte. Las llamadas a la función NetShareSetInfo omiten este miembro.

shi2_passwd

Puntero a una cadena Unicode que especifica la contraseña del recurso compartido cuando el servidor se ejecuta con seguridad de nivel de recurso compartido. Si el servidor se ejecuta con seguridad de nivel de usuario, se omite este miembro. El miembro shi2_passwd no puede tener más de SHPWLEN+1 bytes (incluido un carácter nulo de terminación). Las llamadas a la función NetShareSetInfo omiten este miembro. Tenga en cuenta que Windows no admite la seguridad de nivel de recurso compartido.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado lmshare.h (include Lm.h)

Consulte también

NetShareAdd

NetShareEnum

NetShareGetInfo

NetShareSetInfo

Introducción a la administración de redes

Estructuras de administración de redes

Funciones de recurso compartido de red