Partager via

structure USE_INFO_1 (lmuse.h)

  • Article

La structure USE_INFO_1 contient des informations sur la connexion entre un appareil local et une ressource partagée. Les informations incluent les status de connexion et le type de connexion.

Syntaxe

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;

Membres

ui1_local

Type : LMSTR

Pointeur vers une chaîne qui contient le nom de l’appareil local (par exemple, le lecteur E ou LPT1) redirigé vers la ressource partagée. La constante DEVLEN spécifie le nombre maximal de caractères dans la chaîne. Ce membre peut avoir la valeur NULL. Pour plus d'informations, consultez la section Notes qui suit.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

ui1_remote

Type : LMSTR

Pointeur vers une chaîne qui contient le nom de partage de la ressource distante accessible. La chaîne est au format :

\\servername\sharename

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

ui1_password

Type : LMSTR

Pointeur vers une chaîne qui contient le mot de passe nécessaire pour établir une session entre une station de travail spécifique et un serveur.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE sont définis.

ui1_status

Type : DWORD

Status de la connexion. Cet élément n’est pas utilisé par la fonction NetUseAdd . Les valeurs suivantes sont définies.

Valeur Signification
USE_OK
 La connexion est valide.
USE_PAUSED
 Suspendu par la station de travail locale.
USE_SESSLOST
 Déconnecté.
USE_DISCONN
 Une erreur est survenue.
USE_NETERR
 Une erreur réseau s’est produite.
USE_CONN
 La connexion est établie.
USE_RECONN
 Rebrancher.

ui1_asg_type

Type : DWORD

Type de ressource distante accessible. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
USE_WILDCARD
 Correspond au type des ressources partagées du serveur. Les caractères génériques ne peuvent être utilisés qu’avec la fonction NetUseAdd , et uniquement lorsque le membre ui1_local est NULL. Pour plus d'informations, consultez la section Notes qui suit.
USE_DISKDEV
 Périphérique disque.
USE_SPOOLDEV
 Imprimante en pool.
USE_IPC
 Communication interprocess (IPC).

ui1_refcount

Type : DWORD

Nombre de fichiers, répertoires et autres processus ouverts sur la ressource distante. Cet élément n’est pas utilisé par la fonction NetUseAdd .

ui1_usecount

Type : DWORD

Nombre de connexions explicites (redirection avec un nom d’appareil local) ou de connexions UNC implicites (redirection sans nom d’appareil local) qui sont établies avec la ressource.

Notes

La spécification d’un membre ui1_localnull demande l’authentification auprès du serveur sans rediriger une lettre de lecteur ou un appareil. Les redirections ultérieures impliquant le serveur alors que la même connexion est en vigueur utilisent le mot de passe spécifié par le membre ui1_password dans l’appel initial à la fonction NetUseAdd .

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête lmuse.h (inclure Lm.h)

Voir aussi

NetUseAdd

NetUseEnum

NetUseGetInfo

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Utiliser des fonctions