estructura USE_INFO_1 (lmuse.h)

  • Artículo

La estructura USE_INFO_1 contiene información sobre la conexión entre un dispositivo local y un recurso compartido. La información incluye el estado de conexión y el tipo de conexión.

Sintaxis

typedef struct _USE_INFO_1 {
  LMSTR ui1_local;
  LMSTR ui1_remote;
  LMSTR ui1_password;
  DWORD ui1_status;
  DWORD ui1_asg_type;
  DWORD ui1_refcount;
  DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;

Members

ui1_local

Tipo: LMSTR

Puntero a una cadena que contiene el nombre del dispositivo local (por ejemplo, la unidad E o LPT1) que se redirige al recurso compartido. La constante DEVLEN especifica el número máximo de caracteres de la cadena. Este miembro puede ser NULL. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

ui1_remote

Tipo: LMSTR

Puntero a una cadena que contiene el nombre del recurso compartido al que se accede al recurso remoto. La cadena tiene el formato :

\\servername\sharename

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

ui1_password

Tipo: LMSTR

Puntero a una cadena que contiene la contraseña necesaria para establecer una sesión entre una estación de trabajo específica y un servidor.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

ui1_status

Tipo: DWORD

Estado de la conexión. La función NetUseAdd no usa este elemento. Se definen los valores siguientes.

Valor Significado
USE_OK
 La conexión es válida.
USE_PAUSED
 Pausado por estación de trabajo local.
USE_SESSLOST
 Desconectado
USE_DISCONN
 Se produjo un error.
USE_NETERR
 Error de red.
USE_CONN
 Se está realizando la conexión.
USE_RECONN
 Reconectar.

ui1_asg_type

Tipo: DWORD

Tipo de recurso remoto al que se accede. Este miembro puede ser uno de los valores siguientes.

Valor Significado
USE_WILDCARD
 Coincide con el tipo de recursos compartidos del servidor. Los caracteres comodín solo se pueden usar con la función NetUseAdd y solo cuando el miembro ui1_local es NULL. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
USE_DISKDEV
 Dispositivo de disco.
USE_SPOOLDEV
 Impresora en cola.
USE_IPC
 Comunicación entre procesos (IPC).

ui1_refcount

Tipo: DWORD

Número de archivos, directorios y otros procesos abiertos en el recurso remoto. La función NetUseAdd no usa este elemento.

ui1_usecount

Tipo: DWORD

Número de conexiones explícitas (redireccionamiento con un nombre de dispositivo local) o conexiones UNC implícitas (redireccionamiento sin un nombre de dispositivo local) que se establecen con el recurso.

Comentarios

Especificar un miembro ui1_local que es la autenticación de solicitudes NULL con el servidor sin redirigir una letra de unidad o un dispositivo. Las redirecciones futuras que implican al servidor mientras la misma conexión está en vigor usan la contraseña especificada por el miembro ui1_password en la llamada inicial a la función NetUseAdd .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado lmuse.h (include Lm.h)

Consulte también

NetUseAdd

NetUseEnum

NetUseGetInfo

Introducción a la administración de redes

Estructuras de administración de redes

Uso de funciones