estructura SHARE_INFO_2 (lmshare.h)

Artículo
03/14/2023

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

Introducción a la administración de redes

Estructuras de administración de redes

Funciones de recurso compartido de red