estructura SHARE_INFO_503 (lmshare.h)

Artículo
08/24/2023

Contiene información sobre el recurso compartido. Es idéntico a la estructura de SHARE_INFO_502 , salvo que también contiene el nombre del servidor.

Sintaxis

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Members

shi503_netname

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

shi503_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 de STYPE_MASK .

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

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

Valor	Significado
STYPE_SPECIAL 0x80000000	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 0x40000000	Un recurso compartido temporal.

shi503_remark

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

shi503_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. Tenga en cuenta que Windows no admite la seguridad de nivel de recurso compartido. Este miembro se omite en un servidor que ejecuta la seguridad de nivel de usuario. Para obtener más información sobre cómo controlar el acceso a objetos protegibles, vea Access Control, Privilegios y Objetos protegibles.

Las llamadas a la función NetShareSetInfo omiten este miembro.

Este miembro puede ser cualquiera de los siguientes valores.

Valor	Significado
ACCESS_READ 0x00000001	Permiso para leer datos de un recurso y, de forma predeterminada, para ejecutar el recurso.
ACCESS_WRITE 0x00000002	Permiso para escribir datos en el recurso.
ACCESS_CREATE 0x00000004	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 0x00000008	Permiso para ejecutar el recurso.
ACCESS_DELETE 0x00000010	Permiso para eliminar el recurso.
ACCESS_ATRIB 0x00000020	Permiso para modificar los atributos del recurso (como la fecha y hora en que se modificó por última vez un archivo).
ACCESS_PERM 0x00000040	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 0x00008000	Permiso para leer, escribir, crear, ejecutar y eliminar recursos y modificar sus atributos y permisos.

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

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

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

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

shi503_servername

Puntero a una cadena que especifica el nombre DNS o NetBIOS del servidor remoto en el que reside el recurso compartido. Un valor de "*" indica que no hay ningún nombre de servidor configurado.

shi503_reserved

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

shi503_security_descriptor

Especifica el SECURITY_DESCRIPTOR asociado a este recurso compartido.

Comentarios

El servidor remoto especificado en el miembro shi503_servername debe estar enlazado a un protocolo de transporte mediante la función NetServerTransportAddEx . En la llamada a NetServerTransportAddEx, se deben especificar 2 o 3 para el parámetro level y el valor de SVTI2_SCOPED_NAME debe haberse especificado en la estructura de SERVER_TRANSPORT_INFO_2 para el protocolo de transporte.

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)