estructura USE_INFO_2 (lmuse.h)

  • Artículo

La estructura de USE_INFO_2 contiene información sobre una conexión entre un equipo local y un recurso compartido, incluido el tipo de conexión, el estado de conexión, el nombre de usuario y el nombre de dominio.

Sintaxis

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

Miembros

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

ui2_remote

Tipo: LMSTR

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

\\servername\sharename

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

ui2_password

Tipo: LMSTR

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

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

ui2_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 se realiza correctamente.
USE_PAUSED
 Pausada por una 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.

ui2_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 ui2_local es una cadena 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).

ui2_refcount

Tipo: DWORD

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

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

ui2_username

Tipo: LPWSTR

Puntero a una cadena que contiene el nombre del usuario que inició la conexión.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

ui2_domainname

Tipo: LMSTR

Puntero a una cadena que contiene el nombre de dominio del recurso remoto.

Esta cadena es Unicode si se definen _WIN32_WINNT o FORCE_UNICODE .

Comentarios

Especificar un miembro ui2_local que sea null solicita autenticación 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 información de autenticación especificada en la llamada inicial a la función NetUseAdd . Esta información incluye la combinación de los miembros ui2_password, ui2_username y ui2_domainname .

Requisitos

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