estructura SHARE_INFO_502 (lmshare.h)

Artículo
03/14/2023

Contiene información sobre el recurso compartido, incluido el nombre del recurso, el tipo y los permisos, el número de conexiones y otra información pertinente.

Sintaxis

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Miembros

shi502_netname

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

shi502_type

Combinación de valores que especifican el tipo de 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 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 más información, consulte las funciones de recurso compartido de red.
STYPE_TEMPORARY	Un recurso compartido temporal.

shi502_remark

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

shi502_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. Este miembro se omite en un servidor que ejecuta la seguridad de nivel de usuario. Este miembro puede ser cualquiera 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. Para obtener más información sobre cómo controlar el acceso a objetos protegibles, vea Access Control, Privilegios y Objetos protegibles.

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.

shi502_max_uses

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

shi502_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.

shi502_path

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

shi502_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. Tenga en cuenta que Windows no admite la seguridad de nivel de recurso compartido.

Este miembro 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.

shi502_reserved

Reservados; debe ser cero. Las llamadas a la función NetShareSetInfo omiten este miembro.

shi502_security_descriptor

Especifica el SECURITY_DESCRIPTOR asociado a este recurso compartido.

Requisitos

Requisito	Value
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

Introducción a la administración de redes

Estructuras de administración de redes

Funciones de recurso compartido de red