structure USE_INFO_1 (lmuse.h)

Article
08/24/2023

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)